SUNAT Taxpayer by Document
Look up a Peruvian taxpayer’s full record by identity document (DNI, carné de extranjería, passport, or diplomatic card). found: false when no taxpayer matches.
Supports async delivery: set Prefer: wait=N for an inline result, pass callback_url to receive a POST when ready, or poll GET /jobs/{id}.
Authorizations
Use Authorization: Bearer YOUR_API_KEY
Headers
Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.
255"0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b"
Set wait=N to hold the connection up to N seconds for an inline result. If the job finishes in time you get the normal 200 body; otherwise a 202 with a status_url to poll.
"wait=30"
Body
Identity document number (6-16 alphanumeric characters).
^[A-Za-z0-9]{6,16}$Identity document type: dni, ce (carné de extranjería), passport, or diplomatic. Defaults to dni.
dni, ce, passport, diplomatic POST the job result here when it finishes.
Response
Successful response