Developers
API Reference
SPECIFICATION — PRE-LAUNCH. Planned endpoints, subject to change before release.
| Method | Endpoint | Purpose |
|---|---|---|
| POST | /v1/customers | Customer onboarding & KYC submission |
| GET | /v1/customers/{id}/verification | Check identity verification status |
| GET | /v1/certificates/{reference}/verify | Verify a digital certificate or instrument |
| GET | /v1/wallets/{id}/balance | Retrieve wallet balance (with customer consent) |
| POST | /v1/credit/eligibility | Check credit eligibility for a customer |
| POST | /v1/instruments/echeque | Issue an Immediate e-Cheque |
| POST | /v1/instruments/echeque/post-dated | Issue a Post-Dated e-Cheque |
| POST | /v1/instruments/guarantee | Issue a Digital Guarantee |
| POST | /v1/property/participations | Create a property participation record |
| POST | /v1/notes/subscriptions | Submit an Obotan Notes subscription |
| POST | /v1/merchants | Merchant onboarding |
| POST | /v1/settlements/vendor | Vendor/merchant settlement |
| GET | /v1/reports/transactions | Transaction reporting for reconciliation |
Example Response Shape (specification only)
{
"id": "cert_OBN-OSN-2026-000482",
"status": "verified",
"type": "obotan_notes_certificate",
"issued_at": "2026-01-15T10:00:00Z",
"verification_hash": "sha256:xxxxxxxx"
}Error Codes
| Code | Meaning |
|---|---|
| 400 | Invalid request |
| 401 | Invalid or missing API key |
| 403 | Not authorised for this resource |
| 404 | Resource not found |
| 429 | Rate limit exceeded |
SEC LICENSEDLicensed Crowdfunding Intermediary
VERIFIED PARTICIPANTSIdentity, asset and transaction controls
GOVERNED CREDIT INSTRUMENTSDocumented and auditable workflows
PARTNER-LED SETTLEMENTThrough regulated banking and payment partners
