Embedded Engine Platform
BondMako Developers
The same engines that run inside the platform — invoices, payments, sign, documents, payroll, tax — externalised as one API. Long-lived credentials, least-privilege scopes, idempotent mutations, signed webhooks, metered usage.
Make your first call
Create a sandbox key in the console, then POST to any engine. Mutations require an Idempotency-Key — safe retries return the stored response.
$ curl https://app.bondmako.com/api/v1/invoices \
Engine catalogue
Maturity is honest — PUBLIC_SANDBOX engines self-serve today; PARTNER_PREVIEW ships after its sandbox proofs promote.
| Engine | Family | Maturity | Endpoints | Events | |
|---|---|---|---|---|---|
| Invoice Engine | commercial | PUBLIC SANDBOX | 11 | 4 | Reference → |
| Pricing Oracle | commercial | PUBLIC SANDBOX | 2 | 1 | Reference → |
| Paper Engine | commercial | PUBLIC SANDBOX | 6 | 4 | Reference → |
| Sign Engine | commercial | PUBLIC SANDBOX | 4 | 3 | Reference → |
| Payroll Engine | people | PARTNER PREVIEW | 3 | 1 | Reference → |
| Payments Engine | commercial | PUBLIC SANDBOX | 3 | 2 | Reference → |
| Collections Engine | commercial | PUBLIC SANDBOX | 4 | 1 | Reference → |
| Pact / Contract Engine | commercial | PUBLIC SANDBOX | 4 | 4 | Reference → |
| Proposal Engine | commercial | PUBLIC SANDBOX | 4 | 3 | Reference → |
| Global Tax Engine | people | PARTNER PREVIEW | 2 | 1 | Reference → |
| Hosted Workflows | platform | PUBLIC SANDBOX | 2 | 1 | Reference → |
| Embeddable Components | platform | PUBLIC SANDBOX | 2 | 1 | Reference → |
API conventions
| Authorization | Bearer bm_test_… / bm_live_… or OAuth access token |
| Base path | /api/v1/* on app.bondmako.com |
| Idempotency-Key | Required on mutating endpoints — retries replay the stored response |
| Errors | Structured error.code, error.message, error.requestId |
| Webhooks | Signed deliveries to registered HTTPS endpoints, per environment |
| Rate limit | 120 requests / minute per IP at the gateway |
Usage pricing
Public usage meters — sandbox meters the same events production will.
| Meter | Unit price |
|---|---|
| Invoice draft created | €0.05 / unit |
| Invoice issued | €0.15 / unit |
| Invoice paid | €0.25 / unit |
| Document created | €0.05 / unit |
| Document rendered | €0.10 / unit |
| Template created | €0.05 / unit |
| Sign envelope created | €0.20 / unit |
| Sign envelope sent | €0.25 / unit |
| Proposal created | €0.15 / unit |
| Proposal sent | €0.20 / unit |
| Proposal accepted | €0.25 / unit |
| Contract created | €0.20 / unit |
| Contract sent | €0.25 / unit |