API Overview - Leadblanc

The Leadblanc REST API is built on standard HTTP verbs, JSON request and response bodies, and standard HTTP response status codes.

Base URL

All requests must be directed to our production API gateway:

https://api.leadblanc.com/v1

Authentication

Every API call must include an Authorization header containing your live or test secret API key:

Authorization: Bearer lb_live_9f81a7b3c4d5e6f7...

Never share your secret API key in client-side code, public GitHub repositories, or browser scripts. All API calls using secret keys must be executed from your secure server-side environment.

Status Codes

Code	Status	Meaning
`200`	`OK`	Request succeeded.
`201`	`Created`	Resource successfully created.
`400`	`Bad Request`	Missing required parameters or invalid payload formatting.
`401`	`Unauthorized`	Invalid or missing API key.
`403`	`Forbidden`	API key lacks permission or feature is locked by plan tier.
`429`	`Rate Limited`	Concurrency limit reached. Back off with exponential retry.
`500`	`Server Error`	Internal server fault. Contact support if persistent.

⌘I