Get an invoice
const url = 'https://api.connectato.com/v1/invoices/example';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.connectato.com/v1/invoices/example \ --header 'Authorization: Bearer <token>'Scope: read_invoices.
Authorizations
Section titled "Authorizations"Parameters
Section titled "Parameters"Path Parameters
Section titled "Path Parameters"The public id (inv_...).
Responses
Section titled "Responses"InvoiceResource
object
The invoice’s public id (inv_...).
The order it was issued for (ord_...); null once that order is deleted.
invoice, or storno: the credit note reversing an invoice in full (negative totals and quantities). New values may appear: treat one you do not know as such.
For a storno, the invoice it reverses (inv_...); null for an invoice.
pending (asked, waiting its turn), submitting (the invoicing software is being asked now),
failed (refused or never sent, see error_code; may be asked again), needs_attention
(outcome unknown: a document may exist at the vendor, a person checks it in the app),
issued (numbered, final), cancelled (issued, then cancelled at the vendor),
reversed (issued, then reversed by an issued storno), discarded (no document came of it). New values may appear: treat one you do not know as such.
Why it is failed or needs_attention, a stable code: order_refused, account_unavailable, not_supported, credentials_rejected, rate_limited, invalid_data, vendor_rejected, not_sent, outcome_unknown, document_unread. Null in any other status. New codes may appear. New values may appear: treat one you do not know as such.
The code’s meaning, in English; the app shows the merchant the full reason in their language.
The invoicing software’s own words when it answered, as it sent them, in its language: for display only, never to parse.
The series as the invoicing software numbered it (e.g. FCT); null until issued.
The number inside the series, a string with its leading zeros (e.g. 0042); null until issued.
The document’s date, a plain day in the organization’s calendar; until issued, the day it was asked for.
The payment due day; null for a storno or without one.
The invoicing account it goes through (int_...); null once that integration is removed.
ISO 4217.
Whether the lines’ unit prices include tax.
Net (without tax) + tax = total; negative on a storno.
object
object
object
object
The buyer as invoiced, in the v1 address shape (first_name and last_name null: an invoice names the buyer whole; company = the name for a company buyer), plus its fiscal code and trade register number. The seller is the organization itself and is not copied on the invoice.
object
The lines by position, at most 250 (MAX_LINES); lines_count is the full count.
object
New values may appear: treat one you do not know as such.
The product code (the store’s SKU); null without one.
A decimal string, trailing zeros trimmed (2, 1.5); negative on a storno.
With tax when the invoice’s prices_include_tax.
object
A percentage as a decimal string (21.0000 = 21%).
After discounts: net + tax = total.
object
object
object
How many lines the invoice has.
Example generated
{ "id": "example", "order_id": "example", "kind": "example", "reversed_invoice_id": "example", "status": "example", "error_code": "example", "error_message": "example", "vendor_message": "example", "series": "example", "number": "example", "issue_date": "2026-04-15", "due_date": "2026-04-15", "integration_id": "example", "currency": "example", "prices_include_tax": true, "totals": { "net": { "amount": "example", "currency": "example" }, "tax": { "amount": "example", "currency": "example" }, "total": { "amount": "example", "currency": "example" } }, "buyer": { "name": "example", "first_name": "example", "last_name": "example", "company": "example", "email": "example", "phone": "example", "address_line_1": "example", "address_line_2": "example", "city": "example", "region": "example", "region_code": "example", "postal_code": "example", "country_code": "example", "locality_code": "example", "tax_id": "example", "registration_number": "example" }, "lines": [ { "kind": "example", "code": "example", "name": "example", "quantity": "example", "unit": "example", "unit_price": { "amount": "example", "currency": "example" }, "tax_rate": "example", "net": { "amount": "example", "currency": "example" }, "tax": { "amount": "example", "currency": "example" }, "total": { "amount": "example", "currency": "example" } } ], "lines_count": 1, "created_at": "2026-04-15T12:00:00Z", "updated_at": "2026-04-15T12:00:00Z"}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
No valid access token.
object
The documentation URL of the code.
A short summary of the error, in English.
The HTTP status, repeated.
The stable code: one of bad_request, unauthenticated, insufficient_scope, forbidden, not_found, method_not_allowed, payload_too_large, validation_failed, idempotency_key_required, idempotency_key_invalid, idempotency_key_reused, idempotency_in_progress, conflict, rate_limited, server_error, unavailable, or the code an endpoint declares for a refused action.
The explanation for this case, in English.
Validation only: the messages per field.
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "errors": { "additionalProperty": [ "example" ] }}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
Bearer: send an access token as a Bearer token.
The app was not granted the scope (insufficient_scope).
object
The documentation URL of the code.
A short summary of the error, in English.
The HTTP status, repeated.
The stable code: one of bad_request, unauthenticated, insufficient_scope, forbidden, not_found, method_not_allowed, payload_too_large, validation_failed, idempotency_key_required, idempotency_key_invalid, idempotency_key_reused, idempotency_in_progress, conflict, rate_limited, server_error, unavailable, or the code an endpoint declares for a refused action.
The explanation for this case, in English.
Validation only: the messages per field.
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "errors": { "additionalProperty": [ "example" ] }}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
No such resource in the organization (not_found).
object
The documentation URL of the code.
A short summary of the error, in English.
The HTTP status, repeated.
The stable code: one of bad_request, unauthenticated, insufficient_scope, forbidden, not_found, method_not_allowed, payload_too_large, validation_failed, idempotency_key_required, idempotency_key_invalid, idempotency_key_reused, idempotency_in_progress, conflict, rate_limited, server_error, unavailable, or the code an endpoint declares for a refused action.
The explanation for this case, in English.
Validation only: the messages per field.
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "errors": { "additionalProperty": [ "example" ] }}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
Too many requests: retry after Retry-After seconds.
object
The documentation URL of the code.
A short summary of the error, in English.
The HTTP status, repeated.
The stable code: one of bad_request, unauthenticated, insufficient_scope, forbidden, not_found, method_not_allowed, payload_too_large, validation_failed, idempotency_key_required, idempotency_key_invalid, idempotency_key_reused, idempotency_in_progress, conflict, rate_limited, server_error, unavailable, or the code an endpoint declares for a refused action.
The explanation for this case, in English.
Validation only: the messages per field.
object
Example generated
{ "type": "https://example.com", "title": "example", "status": 1, "code": "example", "detail": "example", "errors": { "additionalProperty": [ "example" ] }}Headers
Section titled "Headers"Requests allowed per minute (per caller; before authentication, failed attempts per address).
Requests left in the current minute.
Seconds to wait before retrying.