Skip to main content
GET
/
v1
/
downloads
/
{id}
/
files
/
{seq}
Error
A valid request URL is required to generate request examples
"string"
{
  "type": "https://errors.invoiceapi.mx/auth_unauthorized",
  "title": "Authentication required",
  "status": 401,
  "code": "auth.unauthorized",
  "detail": "Missing or invalid API key.",
  "remediation": "Send `Authorization: Bearer sk_test_...` (or sk_live_...) with a valid API key.",
  "doc_url": "/docs/errors#auth-unauthorized",
  "request_id": "req_2P9K3sample"
}
{
  "type": "https://errors.invoiceapi.mx/resource_not_found",
  "title": "Resource not found",
  "status": 404,
  "code": "resource.not_found",
  "detail": "No such id in this org + mode.",
  "remediation": "Verify the id and that the key mode (test/live) matches the id.",
  "doc_url": "/docs/errors#resource-not_found",
  "request_id": "req_2P9K3sample"
}
{
  "type": "https://errors.invoiceapi.mx/download_invalid_range",
  "title": "Invalid date range",
  "status": 422,
  "code": "download.invalid_range",
  "detail": "date_from must be on or before date_to.",
  "remediation": "Provide date_from <= date_to.",
  "doc_url": "/docs/errors#download-invalid_range",
  "request_id": "req_2P9K3sample"
}
{
  "type": "https://errors.invoiceapi.mx/rate_limit_exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "rate_limit.exceeded",
  "detail": "Too many requests for this key + request class (reads and writes are limited separately).",
  "remediation": "Back off and retry after the number of seconds in the Retry-After header; batch work or lower your request rate.",
  "doc_url": "/docs/errors#rate_limit-exceeded",
  "request_id": "req_2P9K3sample"
}
{
  "type": "https://errors.invoiceapi.mx/internal_error",
  "title": "Internal server error",
  "status": 500,
  "code": "internal.error",
  "detail": "An unexpected error occurred.",
  "remediation": "Retry later; contact support with the request_id if it persists.",
  "doc_url": "/docs/errors#internal-error",
  "request_id": "req_2P9K3sample"
}

Authorizations

​
Authorization
string
header
required

API key: Authorization: Bearer sk_test_... or sk_live_....

Headers

​
Invoice-Version
string

Pin a dated API release (Stripe-style). Omit to use the current version. An unknown value returns 400 request.invalid_version. Echoed back on every response.

Example:

"2026-07-10"

​
Invoice-Account
string

Connect: act on behalf of one of your connected accounts (its acct_…/org_… id). Omit to act as your own organization. Not honored on /v1/api_keys.

Example:

"org_2P9connectedacct"

Path Parameters

​
id
string
required

Download id, e.g. "dl_2P9K3sample".

Minimum string length: 1
​
seq
integer
required

Zero-based package sequence number to download.

Required range: 0 <= x <= 9007199254740991

Response

Default Response