> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SAT Lima

> Look up outstanding debt owed to the SAT de Lima by DNI, RUC, plate, ticket or taxpayer code: vehicle and property taxes, papeletas and other fines.

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

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

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

```bash theme={"dark"}
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.                               |

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

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

<Note>
  This lookup can take longer than a typical request. It is an
  [async job](/async-jobs). By default the request waits inline and returns
  `{ data }`, or you can poll / use a `callback_url`.
</Note>

<Card title="Full reference" icon="code" href="/api-reference/overview">
  Schemas, all response fields, and an interactive playground.
</Card>