Documents

Send the complete transport details. The response is returned after the encrypted PDF has been generated and stored.

A non-null reference is unique per organization and environment. Repeating a reference with identical normalized data and metadata returns the original result within 24 hours (200), without issuing another PDF. A new creation returns 201. Different data or a reference owned by another credential returns 409 without disclosing documents. Deduplication is not guaranteed without a reference.

A reference whose result has expired returns 409 DOCUMENT_WINDOW_EXPIRED. A deleted document is not returned and its reference cannot be reused; the retry returns 404. Use the PUT endpoints for corrections.

You can request an sk_demo_ token without an account or a registered organisation. It lasts 24 hours from issuance and works only from the public IP that requested it. Changing network or IP requires another token. The demo adds demo: true, expires_at, qr_url (alias of url) and pdf_url (alias of pdf_download_url). document_locale is the language selected when requesting the token (es by default). Temporary data and PDFs are separate from the real archive and are not encrypted like real documents.

Identify the previous document by UUID and send all corrected details, without patches. Only the latest version belonging to the same credential can be corrected. Documents older than 24 hours can be corrected without returning their previous content. A deleted document returns 404 and cannot be corrected.

A corrective document is generated with a new UUID, PDF and QR; the original and its QR are retained. Give the new PDF to the driver. The request body's reference identifies the new version, not the document in the URL.

Repeating the same PUT with identical normalized data and metadata returns the already-issued correction within 24 hours of its creation, without generating another version. This check occurs before rejecting an already-corrected document and also works when the retry identifies the same document by reference. Changing data on an already-corrected document returns 409. An expired retry result returns 409 DOCUMENT_WINDOW_EXPIRED. If the returned correction is deleted, the retry returns 404. For another correction, use the UUID or reference of the latest version.

Logical deletion to correct errors found when generating a document, exclusively before handing it to the carrier or driver and before using it for transport. The integration must confirm both conditions; being within the time limit is not enough. If the document has already been handed over or used, correct it with PUT.

Allowed only while the server time is earlier than created_at + 2 hours; it is no longer allowed at exactly 2 hours. Neither retrieval nor retries restart the period. Each version uses its own creation time. Only the latest version belonging to the authenticated credential can be deleted.

The PDF, data and audit trail are retained, but the document disappears from the list. UUID/reference retrieval, authenticated download, QR access and retries that would return its content respond with 404. The status endpoint returns only status: deleted within the 24-hour read window. The reference remains reserved. There is no reactivation endpoint; deletion retains the file to allow future recovery.

Repeating DELETE within the same 2 hours returns 204 without changing the deletion time. After that period it returns 409.

The first successful access through the QR link also blocks deletion with 409 DOCUMENT_ALREADY_ACCESSED. This access alone does not prove that transport has taken place.

Returns summaries without the PDF, QR secret or metadata. The server always enforces the 24-hour window and credential isolation. Results are ordered by creation time descending, with UUID as a tie-breaker, page-based pagination and inclusive transport-date filters. The window is evaluated on every request; it does not provide a stable snapshot across pages. Historical access is unavailable.

Deleted documents do not appear in the list.

Retrieves the original result within 24 hours, only for the credential that issued the document. Includes all accepted and normalized fields and semantically unchanged metadata.

A nonexistent UUID or reference, one belonging to another credential or one outside the window returns the same 404, without confirming existence or ownership. Each reference identifies its own version and does not redirect to a later correction.

A deleted document returns 404. Use the status endpoint to check whether it has been deleted.

Returns only the status of a document belonging to the authenticated credential, within 24 hours of creation. A deleted document returns 200 with {"status":"deleted"}; no transport data, PDF, QR link or metadata is returned. An active document returns {"status":"active"}.

A nonexistent UUID, one belonging to another credential or one outside the 24-hour window returns the same 404. Deletion does not extend this window.

Returns the exact bytes of the stored PDF without regenerating it. Requires the owning credential and a document age of less than 24 hours. This limit does not affect legal retention or QR validity.

A deleted document returns 404 without delivering the PDF.