API Issuing

API invoice creation is used when you need to issue invoices programmatically by integrating Brinta with your system or ERP.

This option is ideal when you:

1. Want to automate invoice issuance
2. Issue invoices in real time from your own system
3. Work with large or continuous invoice volumes
4. Need a scalable and fully integrated solution

With API invoice creation, you can:

1. Send invoice data directly to Brinta via API
2. Issue invoices without using the dashboard
3. Handle multiple document types programmatically
4. Receive real-time responses and validation results

This method follows the same validation rules as manual and bulk invoicing, including country-specific electronic invoicing requirements.

How it works

All invoice creation goes through a single endpoint:

POST https://api.brinta.com/invoices

The payload structure is the same across all countries and document types. What changes is which fields are required depending on the country and document type you're issuing.

The general flow is:

1. Authenticate — include your API key in the request header.
2. Build the payload — set invoice_type, document_type, and the fields required for your country.
3. Send the request — Brinta validates, stamps, and returns the signed document.
4. Handle the response — check the status and store the invoice ID and fiscal UUID returned.

Authentication

Include your API key in every request:

curl --request POST \
  --url https://api.brinta.com/invoices \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{...}'