Query document

GET /api/v1/facturas/{clave}

Returns the current status of a document by its 50-digit numeric key. Use it to poll estadoHacienda when you don’t have webhooks configured, or to reconcile the integrator’s system against LX CloudPos.

Authentication

Attribute	Value
Required scope	`facturas:read`
Idempotent	Yes (all `GET` requests are)

Path params

Parameter	Type	Description
`clave`	`string`	50-digit numeric key issued by Hacienda (Costa Rica’s tax authority).

Example


curl https://api.pos.lxsyscr.com/api/v1/facturas/50615012600310112345600100001010000000123456789012 \
  -H "X-Api-Key: $LXS_API_KEY"

Responses

`200 OK`


{
  "clave": "50615012600310112345600100001010000000123456789012",
  "numeroConsecutivo": "00100001010000000123",
  "tipoDocumento": "01",
  "estadoHacienda": "aceptado",
  "totalComprobante": 169.50,
  "moneda": "USD",
  "fechaEmision": "2026-05-15T15:32:11Z"
}

`404 Not Found`

The key does not exist in this API key’s tenant. Common causes:

Typo in the key.
The key belongs to another tenant (see tenant isolation).
The document was physically deleted (rare case).