Skip to main content
POST
SUNAT Taxpayer by Document

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

Identity document number (6-16 alphanumeric characters).

Pattern: ^[A-Za-z0-9]{6,16}$
document_type
enum<string>
default:dni

Identity document type: dni, ce (carné de extranjería), passport, or diplomatic. Defaults to dni.

Available options:
dni,
ce,
passport,
diplomatic
callback_url
string<uri>

POST the job result here when it finishes.

Response

Successful response

data
object
required