List the compliance submissions of an invoice
Scopeinvoices:readReturns every submission of this invoice to the tax systems it is owed to, VeriFactu
included, each with its own status, ordered by submitted_at ascending (queued ones,
still without it, last). The invoice's compliance summarises where it stands with each
system; this resource lists what was sent to get there.
- No submissions: an invoice that was never submitted (a draft, a proforma, or one
the company does not report through BeeL.) answers
200with an empty list.
Closed catalogue. This collection is fixed and bounded: it carries no pagination, it
takes no page/limit, and every response holds the whole set.
Keys are prefixed beel_sk_, and each one carries the scopes it was created with: a key
short of the scope an operation needs is answered 403. The scope an operation requires
is shown next to its title, and the full catalogue lives in the Scopes reference.
Keys are created from the BeeL dashboard. They are secret credentials: do not share them or commit them to source control.
In: header
Path Parameters
Unique identifier (UUID) of the company the operation acts on — its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the BeeL-Active-Company header plays no part. A company you do not reach answers 403, and so does a company that does not exist, so the existence of a company in another account is never disclosed.
uuidInvoice ID
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://app.beel.es/api/v1/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/invoices/550e8400-e29b-41d4-a716-446655440000/compliance-submissions"{
"success": true,
"data": {
"submissions": [
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"type": "VERIFACTU",
"operation": "ISSUE",
"status": "FULFILLED",
"system_status": "verifactu:ACCEPTED",
"error_code": null,
"error_message": null,
"submitted_at": "2026-11-12T10:15:01Z",
"updated_at": "2026-11-12T10:15:03Z"
}
]
},
"meta": {
"timestamp": "2026-11-12T10:20:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The parameter 'invoice_id' has an invalid type. Expected: UUID.",
"details": {
"field": "invoice_id",
"invalid_value": "deliveries",
"expected_format": "UUID"
}
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Authentication is required to access this resource"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}{
"success": false,
"error": {
"code": "VALIDATION_ERROR",
"message": "The provided data is not valid",
"details": {
"field": "specific error message"
}
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
},
"type": "https://docs.beel.es/errors/INVOICE_NO_LINES",
"title": "INVOICE_NO_LINES",
"detail": "The invoice must have at least one line",
"instance": "/v1/invoices/abc-123"
}{
"success": false,
"error": {
"code": "INVOICE_NOT_FOUND",
"message": "Invoice not found"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}{
"success": false,
"error": {
"code": "RATE_LIMIT_EXCEEDED",
"message": "Too many requests. Please try again in 60 seconds."
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}{
"success": false,
"error": {
"code": "INTERNAL_ERROR",
"message": "Internal server error"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}{
"success": false,
"error": {
"code": "UNSUPPORTED_MEDIA_TYPE",
"message": "Unsupported media type: text/plain. Supported: application/json"
},
"meta": {
"timestamp": "2025-01-15T10:30:00Z",
"request_id": "4bf92f3577b34da6a3ce929d0e0e4736"
}
}List the VeriFactu records of an invoice GET
Returns the VeriFactu records of this invoice, each with its own status, ordered by `registered_at` ascending: the registration first and, if the invoice was voided, its cancellation after it. A record rejected before reaching the AEAT is listed too, as `REJECTED`, until the invoice is submitted again: the new record then replaces it. - **No records:** an invoice that was never submitted (a draft, or one outside VeriFactu) answers `200` with an empty list. **Closed catalogue.** This collection is fixed and bounded: it carries no `pagination`, it takes no `page`/`limit`, and every response holds the whole set.
Create an invoice (deprecated) POST
Creates an invoice, optionally numbered and issued in the same call with `options.issue_directly: true`. - **Deprecated:** use `POST /v1/companies/{company_id}/invoices`, which behaves identically. **Retires on 9 December 2026.** See the [migration guide](https://docs.beel.es/changelog/resources-under-the-nif) for what moved where and what changes when you switch.