B2B API

Partner API

Offer company formation and registered office to your clients via API. Set your own margins; we handle compliance and Companies House.

Overview

The Partner API lets banks, fintechs, and accountancy firms embed UK company formation and registered office address into their sign-up or client flows. You receive net (wholesale) pricing and set your own retail price. RESTful, API-key authenticated, with OpenAPI 3.0 spec for codegen and explorers.

Packages & add-ons — List formation packages and net prices
Name check — Check company name availability at Companies House
Quote — Get a net-price quote for a formation basket

Authentication

All Partner API requests require an API key. Send it in one of two ways:

Authorization: Bearer YOUR_API_KEY
X-API-Key: YOUR_API_KEY

Endpoints

GET /api/partner/v1/packages

List formation packages and add-ons with net pricing (GBP)

POST /api/partner/v1/name-check

Body: { "company_name": "Acme Ltd" }. Returns availability and similar names.

POST /api/partner/v1/quote

Body: { "package_id": "premium", "add_on_ids": [], "company_name": "..." }. Returns total_net_gbp and breakdown.

Quick start

cURL — list packages:

curl -X GET "https://app.peon.online/api/partner/v1/packages" \
  -H "Authorization: Bearer YOUR_API_KEY"

cURL — name check:

curl -X POST "https://app.peon.online/api/partner/v1/name-check" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"company_name": "Acme Ltd"}'

cURL — quote:

curl -X POST "https://app.peon.online/api/partner/v1/quote" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"package_id": "premium", "add_on_ids": []}'

OpenAPI spec

Download the OpenAPI 3.0 specification for code generation, Postman, or API explorers:

openapi.json

For partnership enquiries, volume pricing, or sandbox access, contact the Peon team. See also Company formation for direct customer flows.