Peru
SAT Lima

SAT Lima Account Status

Look up outstanding debt owed to the SAT de Lima (Servicio de Administración Tributaria de Lima) for a person, company, or vehicle. Pass document_type (dni, ruc, placa, papeleta, cod_administrado, or compromiso; defaults to dni) plus document_number. Returns each outstanding item (taxes such as impuesto vehicular / predial / arbitrios, traffic tickets, administrative fines, and payment commitments) with its group, reference, amount, status, and relevant dates, plus the account total. clear: true means nothing is outstanding.

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}.

post/pe/sat-lima/account-status/v1

Request

  • Base URL: https://api.croma.run
  • URL: https://api.croma.run/pe/sat-lima/account-status/v1
  • Auth: HTTP bearer

Headers

Idempotency-Keystring
Example:0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b

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.

Preferstring
Example:wait=30

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.

Request body

document_type'dni' | 'ruc' | 'placa' | 'papeleta' | 'cod_administrado' | 'compromiso'

Search dimension: dni, ruc, placa (vehicle plate), papeleta (ticket / administrative-fine document), cod_administrado (administered-party code), or compromiso (payment-commitment code). Defaults to dni.

document_numberstring required

The value to look up (1-20 alphanumeric characters).

callback_urlstring uri

POST the job result here when it finishes.

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.