The whole dunning flow, available over API
REST API v1 for people, charges, dunning rules, agreements, disputes, tasks, templates and notifications. Api-key authentication, signed outbound webhooks, and OpenAPI and Postman collections ready to import.
Public API
80+
endpoints in API v1
25+
resources available
HMAC
signature on outbound webhooks
OpenAPI
spec and Postman collection included
From api-key to full automation in four steps
1
Generate your api-key
From the developer area of the dashboard, with control and revocation per key.
2
Integrate the resources
The same resources as the interface: create charges, link dunning rules, query telemetry, open disputes, record agreements.
3
Subscribe to webhooks
Set up outbound endpoints to receive events, with a signed, rotatable secret.
4
Automate
Your ERP creates the charges; the dunning flow handles the rest.
The same resources as the interface, ready to integrate
Complete Resources
People, charges, dunning rules and steps, classifications, templates, notifications, interactions, tasks, agreements and installments, disputes, credit-bureau reports, protests, imports and exports.
- Same business rules as the interface
- State machines respected by the API
- Dashboard and recovery metrics per endpoint
Dual Authentication
Session for the dashboard, api-key for server-to-server integrations.
- Key creation and revocation from the dashboard
- Origin tracking per key
- Scoped per workspace
Outbound Webhooks
Receive Dunning events in your own system, with a verifiable signature and secret rotation.
- Configurable endpoints per event
- One-click secret rotation
- Queryable delivery history
Domain Actions
Beyond CRUD, action endpoints: notify a charge, accept and cancel an agreement, resolve a dispute, complete a task, reclassify a person, issue a portal link.
- POST /v1/charges/{id}/notify
- POST /v1/agreements/{id}/accept
- POST /v1/people/{id}/portal-link
Audit via API
Audit logs queryable by endpoint — the same immutable trail as the interface, integrable with your SIEM or BI.
- Filters by entity and actor
- Before/after on every record
- Append-only, guaranteed by the database
Import and Export
Import portfolios by file, export any resource and track processing jobs.
- Idempotent import
- Asynchronous export with download
- Queryable job status
Integrate in minutes
Example of creating a charge via API:
# Create a charge
curl -X POST https://app.dunning.kobana.com.br/api/v1/charges \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"person_id": "per_123",
"amount": 450.00,
"due_date": "2026-08-15",
"collection_rule_id": "rule_456"
}'
Outbound webhooks: configurable endpoints with delivery history and secret rotation.
Frequently asked questions
Integrate your system with the dunning flow
Talk to us to get access to the interactive documentation and a test key.