# info.description
Generate technically checked EN 16931 ZUGFeRD / Factur-X invoice PDFs for German B2B workflows.

# paths./api/v1.get.summary
Discover fakturai REST and MCP API surfaces

# paths./api/v1.get.description
Returns root discovery metadata for the REST invoice endpoint, hosted MCP endpoint, OpenAPI spec, request schema, and docs.

# paths./api/v1.head.description
Returns discovery headers for the REST invoice endpoint, hosted MCP endpoint, OpenAPI spec, request schema, and docs without a response body.

# paths./api/v1.head.responses.200.headers.Link.description
Service discovery links for OpenAPI, docs, and hosted MCP.

# paths./api/v1.head.responses.200.headers.X-Facturai-Schema.description
Canonical invoice request JSON Schema URL.

# paths./api/v1/invoices.get.summary
Discover the invoice generation endpoint

# paths./api/v1/invoices.get.description
Returns endpoint, authentication, schema, documentation, success, and error metadata for agents.

# paths./api/v1/invoices.head.description
Returns X-Facturai-Docs and X-Facturai-Schema headers without a response body.

# paths./api/v1/invoices.post.description
Creates a ZUGFeRD / Factur-X invoice PDF. Authentication uses either X-API-Key or Authorization: Bearer <key>.

# paths./api/v1/invoices.post.responses.201.description
Invoice generated and returned as a PDF.

# paths./api/v1/invoices.post.responses.201.headers.Content-Disposition.description
Attachment filename for the generated invoice PDF.

# paths./api/v1/invoices.post.responses.201.headers.X-Facturai-Invoice-Id.description
Generated invoice identifier, when available.

# paths./api/v1/invoices.post.responses.201.headers.X-Facturai-Invoice-Number.description
Generated invoice number, when available.

# components.schemas.RootApiDiscovery.properties.endpoints.properties.invoices.properties.auth.example
Send X-API-Key or Authorization: Bearer <key>.

# components.schemas.RootApiDiscovery.properties.endpoints.properties.mcp.properties.discovery.example
Read-only MCP discovery methods are available without an API key.

# components.schemas.RootApiDiscovery.properties.endpoints.properties.mcp.properties.auth.example
Tool calls that generate invoices require X-API-Key or Authorization: Bearer <key>.

# components.schemas.InvoiceApiDiscovery.properties.auth.example
Send X-API-Key or Authorization: Bearer <key>.