API documentation

Endpoints

GET/client/:customerId/invoice/:invoiceId/ix/download

Download InvoiceXpress PDF

Use this endpoint to retrieve the fiscal document created in InvoiceXpress. The API validates the customer and invoice scope before generating the temporary destination.

Request
Build the URL with the parameters below and send the code in the Authorization header.
GEThttps://stripe-ix.betacode.tech/api/v1/client/:customerId/invoice/:invoiceId/ix/download

Inputs and parameters

customerIdpathstring

Stripe Customer ID. Starts with cus_.

Required

invoiceIdpathstring

Stripe Invoice ID. Starts with in_.

Required

Request example

curl -L "https://stripe-ix.betacode.tech/api/v1/client/cus_Q1w2E3r4/invoice/in_1Q2w3E4r/ix/download" \
  -H "Authorization: Bearer ixp_test_YOUR_ACCESS_CODE" \
  --output invoice-ix.pdf
Response
On success, this endpoint returns HTTP 302 with the destination in the Location header.

Output example

HTTP/1.1 302 Found
Location: https://www.app.invoicexpress.com/documents/temporary-pdf-url
Cache-Control: no-store

Behavior

  • The response is HTTP 302, not a JSON body or direct stream.
  • The HTTP client must follow redirects; curl requires the -L option.
  • If the InvoiceXpress document or PDF is not available yet, the API returns an error instead of redirecting.

Integration notes

  • Do not record the temporary URL or Bearer token in application logs.
  • Store the file returned after the redirect, not the temporary URL.