Skip to the story
Startup Launched Sign inTell your storySubmit

Orders API

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

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). Prices a list of products for your listings using the site's current admin prices and validates every option (weeks, categories, billboard minimum). With `promo_code` the answer also shows what the code takes off (before VAT). Nothing is saved or charged.

MCP tool quote_order · needs orders:write

InputWhereTypeDescription
items requiredbodyarrayWhat to buy
billing_countrybodystringISO country code for the VAT preview, e.g. GB, DE, US
vat_numberbodystringVAT number for the VAT preview (EU businesses: reverse charge when valid)
promo_codebodystringPromo code the user gave you, exactly as typed. Checked with the same rules as the cart; a code that cannot be used is refused with the reason (nothing is built). Never guess codes: wrong tries are rate-limited
curl -X POST "https://startuplaunched.com/api/v1/orders/quote" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items": "\u2026"}'

POST/api/v1/orders/checkout

Get a secure checkout link. Builds an order and returns `checkout_url`: a secure page on this site where the person reviews the order, enters billing details and pays THEMSELVES (card, Apple/Google Pay, PayPal or crypto). Give the link to the user; never ask them for card details. A `promo_code` is put in the cart and checked again when they pay. After payment, get_order shows the status. Send an Idempotency-Key header to make retries safe.

MCP tool create_checkout · needs orders:write · accepts Idempotency-Key

InputWhereTypeDescription
items requiredbodyarrayWhat to buy
billing_countrybodystringISO country code for the VAT preview, e.g. GB, DE, US
vat_numberbodystringVAT number for the VAT preview (EU businesses: reverse charge when valid)
promo_codebodystringPromo code the user gave you, exactly as typed. Checked with the same rules as the cart; a code that cannot be used is refused with the reason (nothing is built). Never guess codes: wrong tries are rate-limited
curl -X POST "https://startuplaunched.com/api/v1/orders/checkout" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items": "\u2026"}'

GET/api/v1/orders

Your orders. Your orders on this site, newest first, with status (pending, paid, ...).

MCP tool list_my_orders · needs account:read · paginated

InputWhereTypeDescription
pagequeryintegerPage number (1-based) (default 1)
per_pagequeryintegerItems per page (default 20)
curl "https://startuplaunched.com/api/v1/orders" \
  -H "Authorization: Bearer $API_KEY"

GET/api/v1/orders/{number}

One order and its status. An order's status, totals with VAT, lines and whether each was fulfilled.

MCP tool get_order · needs account:read

InputWhereTypeDescription
number requiredpathstringOrder number
curl "https://startuplaunched.com/api/v1/orders/1" \
  -H "Authorization: Bearer $API_KEY"

GET/api/v1/products

Products and prices. Everything you can buy on this site with its current price in USD cents (set by the site's admin; never hardcode prices). `needs_listing` products are bought for one of your listings. Prices exclude VAT; use quote_order for VAT.

MCP tool list_products · public, no sign-in

curl "https://startuplaunched.com/api/v1/products"
Help centre