Skip to main content
SaaS Directory Info

Reference edition 2026.40

Sign in

Orders API

Base URL https://saasdirectoryinfo.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). 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)
curl -X POST "https://saasdirectoryinfo.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. 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)
curl -X POST "https://saasdirectoryinfo.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://saasdirectoryinfo.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://saasdirectoryinfo.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://saasdirectoryinfo.com/api/v1/products"
Questions?