REST APIs for every Kobana product

One standard across all products: JSON, Bearer tokens, idempotency. Pick a product, copy the base URL and make your first call.

Pick a product Connect an agent (MCP)

The same standard across all products

Learn one Kobana API and you know them all.

JSON and snake_case: JSON requests and responses, with snake_case fields and ISO 8601 dates.
Values in BRL: Monetary values as a number in reais (149.90), never in cents.
Bearer token: Authorization: Bearer <token>, issued by the Kobana Account. Each product documents its scopes.
Idempotency: Send X-Idempotency-Key on creations: repeating the call returns the result of the first one.
Sandbox in the Banking Gateway: The Banking Gateway has a test environment separate from production, to validate before going live.
Rate limits: Each product documents its request limits, so you can size the integration from day one.

APIs by product

Base URL, an example call and the full documentation for each product.

Banking Gateway

Bank slips, Pix, Automatic Pix, payments, transfers, statements, remittance and return files, in API v1 and v2.

Has official SDKs in Ruby, PHP, Python and Node.js.

Base URL · Production: https://api.kobana.com.br
Base URL · Sandbox: https://api.sandbox.kobana.com.br

API documentation →OpenAPI specification →Postman collection →

Example

curl https://api.kobana.com.br/v1/bank_billets \
  -H "Authorization: Bearer $KOBANA_TOKEN"

Automatic Billing

Customers, plans, subscriptions, invoices, payments, tax invoices, proposals and usage.

Base URL · Production: https://api.billing.kobana.com.br

API documentation →OpenAPI specification →Postman collection →

Example

curl https://api.billing.kobana.com.br/v1/subscriptions \
  -H "Authorization: Bearer $KOBANA_TOKEN"

Smart Finance

Payables and receivables, transactions, reconciliation, financial accounts, cash flow and registers.

Send the workspace in the X-Workspace-Id header.

Base URL · Production: https://api.finance.kobana.com.br

API documentation →OpenAPI specification →Postman collection →

Example

curl https://api.finance.kobana.com.br/v1/financial-accounts \
  -H "Authorization: Bearer $KOBANA_TOKEN" \
  -H "X-Workspace-Id: $WORKSPACE_ID"

Dunning

Customers, charges, dunning flows, agreements, disputes, tasks, imports and webhooks.

Base URL · Production: https://api.dunning.kobana.com.br

API documentation →OpenAPI specification →Postman collection →

Example

curl "https://api.dunning.kobana.com.br/v1/people?per_page=5" \
  -H "Authorization: Bearer $KOBANA_TOKEN"

Magic Dashboard

Organization, portal users, entities, connectors, API keys and webhooks.

Base URL · Production: https://api.dashboards.kobana.com.br

API documentation →OpenAPI specification →Postman collection →

Example

curl https://api.dashboards.kobana.com.br/v1/organization \
  -H "Authorization: Bearer $KOBANA_TOKEN"

Official SDKs, in the Banking Gateway

If you integrate with the Banking Gateway, use the official Ruby, PHP, Python and Node.js libraries instead of building requests by hand.

See the Gateway SDKs

After your first call

MCP servers

Give an AI agent access to the same resources, with the permissions of whoever authorized it.

See the MCP servers →

CLI

Automate in the terminal and in CI pipelines, without writing the HTTP client.

See the CLI →

Webhooks

Receive Banking Gateway events in real time, signed with HMAC.

See webhooks →

Sandbox

Test without moving real money.

See the sandbox →

Need help integrating?

Talk to our engineering team about your use case.

Schedule a call