---
title: "Fetch invoice metadata"
method: GET
path: "/api/v1/invoices/{id}"
---

# Fetch invoice metadata

`GET /api/v1/invoices/{id}`

Returns the Invoice for a previously-generated invoice. Read path is wired alongside the scribo session cookie; cross-tenant probes return 404.

## Path parameters

- `id` string, uuid, required — Invoice UUID

## Response `200`

Invoice metadata

- Invoice
  - `invoice_id` string, uuid, required
  - `document_id` string, uuid, required
  - `format` 'zugferd_comfort' | 'zugferd_basic' | 'xrechnung_cii' | 'xrechnung_ubl' | 'plain_pdf', required
  - `download_url` string, uri, required
  - `download_url_expires_at` string, date-time, required
  - `preview_url` string, uri
  - `preview_url_expires_at` string, date-time
  - `submission` object
    - `status` 'not_provided', required
    - `message` string, required
    - `manual_upload_hints` object[]
      - `label` string, required
      - `url` string, uri, required
      - `leitweg_prefix` string
    - `planned` string[]
  - `validator_summary` object, required
    - `valid` boolean, required
    - `validator` string, required
    - `errors` object[]
      - `path` string
      - `rule` string
      - `message` string, required
  - `magic_link_sent` boolean, required
  - `recipient_email_sent` boolean

## Other responses

- `404` — Invoice not found or not visible to this caller

---

[API](https://skmtc.net/causaprima/apis/scribo-invoice-api.md) · [All operations](https://skmtc.net/causaprima/apis/scribo-invoice-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/causaprima/scribo-invoice-api/revisions/73eb15ab4d15/schema)