# 📄 Get invoice status and file download links

Get an invoice's current status, its status details, and file download links.

Returns the invoice's lifecycle status and status details, plus download URLs for the
requested format(s). If no format is specified, links for all available formats are returned.

Supported formats:
- facturx: FacturX PDF with embedded XML (French standard)
- ubl: Universal Business Language XML
- cii: Cross Industry Invoice XML

Endpoint: GET /invoicing/invoices/{invoice_id}
Version: 0.29.6
Security: APIKeyHeader

## Path parameters:

  - `invoice_id` (string, required)

## Query parameters:

  - `format` (any)
    specific format to get download link for

## Header parameters:

  - `X-PDP-Client-Id` (string, required)
    ID of the PDP Client for which the operation is performed

## Response 200 fields (application/json):

  - `invoice_id` (string, required)
    Invoice ID

  - `status` (any)
    Current invoice status

  - `direction` (any)
    Invoice direction (incoming/outgoing)

  - `invoice_number` (any)
    Invoice number

  - `created_at` (any)
    When the invoice was created

  - `seller` (any)
    Seller information

  - `buyer` (any)
    Buyer information

  - `currency_code` (any)
    Currency code

  - `total_amount` (any)
    Total invoice amount

  - `available_formats` (array, required)
    List of available download formats

  - `available_formats.format` (string, required)
    Supported e-invoicing formats for file downloads.
    Enum: "facturx", "ubl", "cii"

  - `available_formats.download_url` (string, required)
    Pre-signed download URL

  - `available_formats.expires_at` (string, required)
    When the download link expires

  - `available_formats.file_name` (string, required)
    Suggested filename for download

  - `available_formats.file_size` (any)
    File size in bytes

  - `available_formats.content_type` (string, required)
    MIME content type

  - `generated_at` (string, required)
    When the download links were generated

  - `status_details` (any)
    Typed status-transition details; shape depends on `status`.

  - `status_details.PeppolSendingFailed` (any)

  - `status_details.NotPeppolRoutable` (any)

  - `status_details.InvoiceSerializationFailed` (any)

  - `status_details.InvalidInputError` (any)

  - `status_details.reason_code` (any)
    Deposit reason code (MDT-113); NON_TRANSMISE when the recipient is not reachable.

  - `status_details.reason_text` (any)
    Deposit reason label (MDT-114).

  - `status_details.approval_reason_code` (any)
    Partial-approval motive (MDT-113); present only on a partial approval (206).

  - `status_details.approval_reason_text` (any)
    Partial-approval motive label (MDT-114).

  - `status_details.approval_amounts` (any)
    Approved and unapproved amounts (MDG-43); present only on a partial approval.

  - `status_details.approval_amounts.type` (any)
    Amount type (MDT-207): MAP/MAPTTC/MNA/MNATTC.

  - `status_details.approval_amounts.amount` (any)
    The amount (MDT-215, G7.07).

  - `status_details.approval_amounts.tax_rate` (any)
    VAT rate the amount applies to, as a percentage (MDT-224, G1.24).

  - `status_details.comment` (any)
    Free-text note attached to the acceptance (MDT-126).

  - `status_details.refusal_reason_code` (any)
    Refusal reason code (MDT-113).

  - `status_details.refusal_reason_text` (any)
    Refusal reason label (MDT-114).

  - `status_details.refusal_comment` (any)
    Comment explaining the refusal (MDT-126).

  - `status_details.rejection_reason_code` (any, required)
    Deprecated alias of refusal_reason_code.

  - `status_details.rejection_reason_text` (any, required)
    Deprecated alias of refusal_reason_text.

  - `status_details.rejection_comment` (any, required)
    Deprecated alias of refusal_comment.

  - `status_details.rejection_reason_code` (any)
    Rejection reason code (MDT-113).

  - `status_details.rejection_reason_text` (any)
    Rejection reason label (MDT-114).

  - `status_details.rejection_comment` (any)
    Comment explaining the rejection (MDT-126).

  - `status_details.payment_amount` (any)
    Amount paid, plain notation (MDT-215, G7.07). Absent when full payment was reported.

  - `status_details.payment_tax_rate` (any)
    VAT rate the payment applies to, as a percentage (MDT-224, G1.24).

  - `status_details.payment_date` (any)
    Date the payment was made, as YYYYMMDD text.

  - `status_details.comment` (any)
    Free-text note attached to the payment (MDT-126).

  - `status_details.payment_breakdowns` (any)
    Per-VAT-rate collected amounts (MDG-43, G7.45).

  - `status_details.payment_breakdowns.amount` (any)
    Amount collected incl. VAT for this rate, plain notation (MDT-215, G7.07).

  - `status_details.payment_breakdowns.tax_rate` (any)
    VAT rate this amount applies to, as a percentage (MDT-224, G1.24).

  - `status_details.comment` (any)
    Free-text note attached to the cash receipt (MDT-126).

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)