API reference

Base URL https://launchtrophies.com/api/v1. Machine-readable: OpenAPI 3.1. Each operation is also an MCP tool with the same name.

Site

Who this site is and what it offers

• GET /api/v1/site: About this site and its API (tool get_site_info)

Categories

Categories and subcategories

• GET /api/v1/categories: List categories and subcategories (tool list_categories)
• GET /api/v1/categories/{slug}: Get a category with its top listings (tool get_category)

People

Founders and their stories

• GET /api/v1/founders: Find founders (tool list_founders)
• GET /api/v1/founders/{slug}: Get a founder with companies and stories (tool get_founder)

Content

Blog posts and guides

• GET /api/v1/blog: List or search blog posts (tool list_blog_posts)
• GET /api/v1/blog/{slug}: Read a blog post (tool get_blog_post)

Account

Your account (needs sign-in)

• GET /api/v1/me: Your account (tool get_account, needs account:read)

Orders

Prices, VAT preview and secure checkout links (needs sign-in to build an order)

• POST /api/v1/orders/quote: Price an order (with VAT preview) (tool quote_order, needs orders:write)
• POST /api/v1/orders/checkout: Get a secure checkout link (tool create_checkout, needs orders:write)
• GET /api/v1/orders: Your orders (tool list_my_orders, needs account:read)
• GET /api/v1/orders/{number}: One order and its status (tool get_order, needs account:read)
• GET /api/v1/products: Products and prices (tool list_products)

Trophies

Trophy cabinets, awards and their verification, leaderboards, Hall of Fame, programmes to enter

• GET /api/v1/trophies/cabinets: Search trophy cabinets (tool list_trophy_cabinets)
• GET /api/v1/trophies/cabinets/{slug}: One trophy cabinet (tool get_trophy_cabinet)
• GET /api/v1/trophies/leaderboards: Trophy leaderboard (tool trophy_leaderboard)
• GET /api/v1/trophies/hall-of-fame/{year}: Hall of Fame for a year (tool hall_of_fame)
• GET /api/v1/trophies/programmes: Award programmes (tool list_award_programmes)
• GET /api/v1/trophies/my-cabinets: Your trophy cabinets (tool my_trophy_cabinets, needs account:read)
• POST /api/v1/trophies/cabinets/{slug}/awards: Add an award you won elsewhere (by URL) (tool add_external_award, needs listings:write)