Skip to main content
POST
/
pe
/
sunat
/
taxpayers
/
v1
SUNAT Taxpayers
curl --request POST \
  --url https://api.croma.run/pe/sunat/taxpayers/v1 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "document_number": "20100070970"
}
'
{
  "data": {
    "found": true,
    "ruc": "<string>",
    "taxpayer_name": "<string>",
    "taxpayer_type": "<string>",
    "taxpayer_status": "<string>",
    "taxpayer_condition": "<string>",
    "fiscal_address": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Use Authorization: Bearer YOUR_API_KEY

Headers

Prefer
string

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.

Example:

"wait=30"

Body

application/json
document_number
string
required

8-digit DNI or 11-digit RUC.

Pattern: ^\d{8,11}$
callback_url
string<uri>

POST the job result here when it finishes.

Response

Successful response

data
object
required