Fac-360
Artifacts

List public artifacts for a tenant-owned document

Returns safe metadata only. Internal object keys, HTML render inputs and unsigned XML are never exposed.

GET
/api/v2/documents/{id}/artifacts

Returns safe metadata only. Internal object keys, HTML render inputs and unsigned XML are never exposed.

Authorization

bearerAuth
AuthorizationBearer <token>

Tenant-bound, scoped and expiring Apifact credential. Migrated legacy credentials are accepted only on deprecated v1 writes and tenant-scoped v2 read, poll and download routes. Each operation names the single scope it requires in x-required-scope; the scope array of the security requirement itself is empty because OpenAPI 3.0 requires it to be for a non-oauth2 scheme.

In: header

Path Parameters

id*string
Formatuuid

Query Parameters

representationLimit?integer
Range1 <= value <= 100
representationCursor?string
Length1 <= length <= 256

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v2/documents/497f6eca-6276-4993-bfeb-53cbbbba6f08/artifacts" \  -H "Authorization: Bearer apf_v2_tu_credencial"
{  "schemaVersion": "2.0",  "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6",  "documentId": "4704590c-004e-410d-adf7-acb7ca0a7052",  "artifacts": [    {      "kind": "signed-xml",      "status": "PENDING",      "mediaType": "application/xml",      "byteSize": 0,      "sha256": "string",      "readyAt": "2019-08-24T14:15:22Z"    }  ],  "representations": [    {      "representationId": "a9b73a9c-9bfc-4552-8caa-c8f5de61ac57",      "kind": "pdf-a4",      "version": 1,      "status": "PENDING",      "templateVersion": "invoice-a4-v2",      "rendererVersion": "browser-run-a4-v1",      "mediaType": "application/pdf",      "byteSize": 0,      "sha256": "string",      "readyAt": "2019-08-24T14:15:22Z",      "downloadPath": "string"    }  ]}

Durably request immutable PDF representations POST POST

Pins canonical and signed-XML sources plus explicit template/renderer versions. Generation is asynchronous and never changes fiscal document state. Admission is limited to factura 01 and boleta 03; a 07 or 08 note obtains its QR and representations from its own accepted or observed submission.

Stream and integrity-check a public document artifact GET GET

Streams immutable bytes through a private R2-only service after tenant authorization and metadata integrity checks. Range requests are not supported.