---
title: "Extract the embedded XML and key fields from a Factur-X PDF or e-invoice XML"
method: POST
path: "/v1/invoices/extract"
tags: ["e-invoicing"]
---

# Extract the embedded XML and key fields from a Factur-X PDF or e-invoice XML

`POST /v1/invoices/extract`

## Request

- Base URL: `https://facturx.orvel.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://facturx.orvel.dev/v1/invoices/extract`
- Auth: none declared

## Query parameters

- `include_xml` boolean

## Response `200`

Successful Response

- ExtractOut
  - `flavor` string, required
  - `profile` string, nullable, required
  - `guideline` string, nullable, required
  - `xml_filename` string, nullable, required
  - `fields` object, required
  - `pdf` object, nullable, required
  - `xml` string, nullable

## Other responses

- `400`: Invalid input or business-rule failure
- `401`: Missing or invalid API key
- `402`: Monthly quota exceeded
- `422`: Validation Error
- `503`: Validation engine temporarily unavailable

---

[API](https://skmtc.dev/orvel/apis/factur-x-api.md) · [All operations](https://skmtc.dev/orvel/apis/factur-x-api/llms.txt) · [OpenAPI document](https://skmtc.dev/orvel/apis/factur-x-api/revisions/1dc1acc1104e?raw)