---
title: "SAT Lima Account Status"
method: POST
path: "/pe/sat-lima/account-status/v1"
tags: ["Peru", "SAT Lima"]
---

# SAT Lima Account Status

`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

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

## Headers

- `Idempotency-Key` string
- `Prefer` string

## Request body

- object
  - `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_number` string, required: The value to look up (1-20 alphanumeric characters).
  - `callback_url` string, uri: POST the job result here when it finishes.

## Response `200`

Successful response

- SatLimaAccountStatusResponse
  - `data` SatLimaAccountStatusData, required
    - `found` boolean, required: Whether the source resolved an account (false only on a genuinely empty result).
    - `query` string, required: Echoes the searched value (trimmed, uppercased).
    - `document_type` 'dni' | 'ruc' | 'placa' | 'papeleta' | 'cod_administrado' | 'compromiso', required: The search dimension used.
    - `clear` boolean, required: True when there is nothing outstanding.
    - `summary` object, required
      - `total` number, nullable, required: Sum of the outstanding amounts, in PEN.
      - `items_count` number, required
    - `debts` object[], required
      - `group` string, nullable, required: Human label for the debt group (e.g. "Papeletas", "Impuesto vehicular").
      - `group_code` number, nullable, required
      - `concept_code` number, nullable, required
      - `reference` string, nullable, required
      - `document` string, nullable, required
      - `plate` string, nullable, required: Plate, for vehicle-bound items (papeletas / vehicular).
      - `amount` number, nullable, required: Outstanding amount, in PEN.
      - `amount_with_discount` number, nullable, required
      - `status` string, nullable, required
      - `year` number, nullable, required: Tax year, for tax items.
      - `installment` string, nullable, required
      - `due_date` string, nullable, required: Due date (yyyy-mm-dd when parseable).
      - `infraction_date` string, nullable, required: Infraction date (yyyy-mm-dd when parseable).
      - `violation_code` string, nullable, required
      - `violation` string, nullable, required
      - `regulation` string, nullable, required

## Other responses

- `202`: Accepted — the result is being computed asynchronously. Poll `job.status_url` (GET /jobs/{id}) or supply `callback_url` to have the result POSTed to you. Returned when `Prefer: wait` elapses before completion, or immediately when `callback_url` is set.
- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)