Invoices

Retrieve an invoice

Same fields as the list, plus earnings: a fee/VAT/net breakdown, present only for a card/bank Merchant-of-Record sale with a linked, settled transaction. null otherwise (crypto sales, or a not-yet-paid issued invoice).

get/gateway/invoices/{invoiceId}

Request

  • Base URL: https://api.agentaos.ai/api/v1
  • URL: https://api.agentaos.ai/api/v1/gateway/invoices/{invoiceId}
  • Auth: API key in header x-api-key

Path parameters

invoiceIdstring uuid required

Invoice UUID.

Response

The invoice, with its earnings breakdown.

idstring uuid required
invoice_numberstring required

Human-readable, e.g. INV-2026-0142.

transaction_idstring uuid nullable required

Linked settled transaction, once paid.

session_idstring nullable required

Linked checkout.

amountnumber required

Currency units.

currencystring required
payment_tokenstring required

What the buyer paid (or will pay) with.

status'issued' | 'paid' | 'voided' required

issued (created, not yet paid), paid (payment settled), or voided.

fiat_amountnumber nullable required

EUR/USD equivalent, for stablecoin payments.

fiat_currency'EUR' | 'USD' | 'null' nullable required
exchange_ratenumber nullable required

Rate applied at settlement.

exchange_rate_sourcestring nullable required
tax_ratenumber nullable required

Applied rate, e.g. 19 for 19%.

tax_amountnumber nullable required

Currency units.

tax_namestring nullable required

e.g. DE VAT.

tax_inclusiveboolean nullable required

Whether amount already includes tax.

merchant_namestring nullable required

Seller name on the document.

buyer_emailstring nullable required
buyer_namestring nullable required
buyer_companystring nullable required
buyer_countrystring nullable required

ISO 3166-1 alpha-2.

buyer_vatstring nullable required
tx_hashstring nullable required

On-chain hash, for crypto payments.

issued_atstring date-time required
voided_atstring date-time nullable required
created_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.