Skip to main content
GET
Retrieve a fiscal document

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

Fiscal document id, e.g. "fdoc_2P9K3sample".

Minimum string length: 1

Response

Default Response

object
enum<string>
required

Always "fiscal_document".

Available options:
fiscal_document
id
string
required

Fiscal document id, e.g. "fdoc_2P9K3sample".

fiscal_profile_id
string
required

The fiscal profile this document belongs to.

type
enum<string>
required

Always "constancia" for now.

Available options:
constancia
status
enum<string>
required

pending: accepted, not started yet (also the state while our SAT document service is at capacity). processing: the document is being fetched. ready: the PDF can be downloaded. needs_action: stopped until someone acts, see error. failed: did not complete. cancelled: the request was cancelled. expired: the PDF was removed after the retention period.

Available options:
pending,
processing,
ready,
needs_action,
failed,
cancelled,
expired
livemode
boolean
required

False for test mode: the PDF is simulated and is not a SAT document.

deadline
string
required

When we stop working on this request, ISO-8601 UTC.

sha256
string | null
required

SHA-256 (hex) of the PDF once it is ready.

size_bytes
integer | null
required

PDF size in bytes once it is ready.

Required range: -9007199254740991 <= x <= 9007199254740991
pdf_url
string | null
required

Path to download the PDF; null unless status is ready.

pdf_expires_at
string | null
required

When the PDF is deleted from our storage, ISO-8601 UTC.

error
object | null
required

Why it stopped, set on needs_action, failed and cancelled; null otherwise.

created_at
string
required

Creation timestamp, ISO-8601 UTC.

updated_at
string
required

Last-update timestamp, ISO-8601 UTC.

ready_at
string | null
required

When the PDF was stored, ISO-8601 UTC.