SAT Lima

Resolves outstanding debt owed to the SAT de Lima (Servicio de Administración Tributaria de Lima) for a person, company, or vehicle: taxes (impuesto vehicular, predial, arbitrios, alcabala), traffic tickets (papeletas), administrative fines, and payment commitments. One lookup, selected by document_type.

Account status

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

Field	Type	Notes
`document_type`	string	One of `dni`, `ruc`, `placa` (vehicle plate), `papeleta` (ticket / administrative-fine document), `cod_administrado` (administered-party code), `compromiso` (payment-commitment code). Defaults to `dni`.
`document_number`	string	Required. The value to look up, 1-20 alphanumeric characters.

curl https://api.croma.run/pe/sat-lima/account-status/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_type": "placa", "document_number": "ABC123" }'

Response

Field	Notes
`found`	`true` when an account resolved (even with zero debt); `false` only on a genuinely empty result.
`query`	The searched value (trimmed, uppercased).
`document_type`	The search dimension used.
`clear`	`true` when there is nothing outstanding.
`summary.total`	Sum of the outstanding amounts, in PEN (null when there is no debt).
`summary.items_count`	Number of outstanding items.
`debts[]`	The outstanding items (see below).

Each item in debts[]:

Field	Notes
`group`	Human label for the debt group (e.g. `Papeletas`, `Impuesto vehicular`, `Arbitrios municipales`).
`group_code`, `concept_code`	Source group / concept codes.
`reference`	Reference or document identifier for the item.
`document`	Source document field.
`plate`	Plate, for vehicle-bound items.
`amount`	Outstanding amount, in PEN.
`amount_with_discount`	Discounted amount when offered.
`status`	Item status.
`year`, `installment`	Tax year and installment, for tax items.
`due_date`	Due date (`yyyy-mm-dd` when parseable).
`infraction_date`	Infraction date (`yyyy-mm-dd` when parseable), for tickets and fines.
`violation_code`, `violation`, `regulation`	Violation code, description, and regulation, for tickets and fines.

{
  "data": {
    "found": true,
    "query": "ABC123",
    "document_type": "placa",
    "clear": true,
    "summary": { "total": null, "items_count": 0 },
    "debts": []
  }
}

dni and ruc resolve the registered party before listing debt, so they can take a little longer than a plate or code lookup.

This lookup can take longer than a typical request. It is an async job. By default the request waits inline and returns { data }, or you can poll / use a callback_url.

Full reference

Schemas, response fields, and an interactive playground.

Get Started

Colombia

Peru

Global

Account status

Response

Full reference

​Account status

​Response

Full reference

Account status

Response