Brrndops API

The Brrndops API lets your software do what Brrndops users do by hand: create professional invoices, render them as branded PDFs and send them to customers by email. Your customers get the same polished documents, and your team never has to retype an order.

QuickstartCreate your first invoice in about five minutes.

API referenceEvery endpoint, field and response.

Sandbox and productionTest freely, then go live when you're verified.

Handling errorsEvery error code and what to do about it.

How it works

1. Get a sandbox key

Sign in to the developer dashboard, create your business and generate a bd_test_… key. Sandbox is free.

2. Build your integration

Create invoices, download PDFs and test sending, all with test data that never reaches real customers.

3. Verify and go live

Verify your business, choose a plan and switch to a bd_live_… key. Your code doesn’t change.

The basics

Base URL	https://api.brrndops.com/v1
Format	JSON requests and responses, UTF-8
Authentication	Authorization: Bearer <secret key> (details)
Environment	Decided by the key: bd_test_… is sandbox, bd_live_… is production
Money	Integers in the currency’s minor unit, e.g. 150000 NGN = ₦1,500.00 (details)
Dates	Calendar dates as YYYY-MM-DD; timestamps in RFC 3339 UTC
IDs	Prefixed by type, e.g. inv_… for invoices