Get Customer Invoices

GET/fina/v1/invoices

Retrieves the customer-visible invoices associated with an order, including short-lived signed download URLs.

Different envelope

Failures on this endpoint are signalled by success: false with a message — there is no numeric error_code field.

Filtered server-side

Only CREDIT_LIABILITY invoices that already have a stored document are returned, so the list is empty until FINA has generated one — an invoice you attached via Add FINA Invoice does not appear here.

Request

order_numberstringrequiredquery param

The order_id returned by Initiate Checkout.e.g. F26070910AB3XKQ70

Response

successboolean

true when the lookup succeeded.

messagestring

Failure reason when success is false.

array

Customer-visible invoices for the order.

idstring

FINA's invoice record id.

invoice_numberstring

Invoice number.

invoice_type_namestring

Invoice category, e.g. "CREDIT_LIABILITY".

status_nameenum

Generation status of the invoice document.PENDINGPROCESSINGCOMPLETEDFAILED

urlstring

Storage path of the invoice (not directly downloadable).

expiring_urlstring

Signed download URL, valid for ~10 minutes. Fetch again when it expires.

invoice_typenumber

Numeric invoice-type code.

statusnumber

Numeric status code.

Sandboxhttps://apibe.silqfi.xyz

GET /fina/v1/invoices

curl -X GET "https://apibe.silqfi.xyz/fina/v1/invoices?order_number=F26070910AB3XKQ70" \
  -H "Authorization: bearer FINA_BEARER_TOKEN"

FINA_BEARER_TOKEN is provided by the FINA team, per environment. Contact the FINA team for the production base URL.

Response · 200 · Success

{
  "success": true,
  "message": "",
  "order_invoices": [
    {
      "id": "8234",
      "invoice_number": "10-01-1-2604922",
      "invoice_type": 3,
      "status": 4,
      "url": "invoices/04-2026/CREDIT_LIABILITY/invoice_11439_1776618063.pdf",
      "expiring_url": "https://storage.googleapis.com/.../invoice_11439_1776618063.pdf?X-Goog-Expires=599&X-Goog-Signature=...",
      "invoice_type_name": "CREDIT_LIABILITY",
      "status_name": "COMPLETED"
    }
  ]
}

PreviousAdd FINA Invoice