Skip to content

Reference / SUNAT

Taxpayers without operating capacity

Whether a tax ID appears on SUNAT's register of taxpayers without operating capacity.

GET /api/sunat/ssco/{ruc}

What it's for: Rule out a supplier whose invoices SUNAT would not allow as tax credit.

Authentication

X-API-Key string header required
X-API-Key: tu_token
Authorization string header
Authorization: Bearer tu_token

Either one works. The token is generated from the client dashboard. Go to the dashboard →

Path parameters

ruc string required
11-digit tax ID (RUC). Example: 20123456789

Response

Main fields this lookup returns:

  • ruc
  • razon_social
  • domicilio_fiscal
  • resolucion_atribucion_ssco
  • fecha_emision_resolucion_atribucion
  • fecha_resolucion_firme
  • representante_legal
  • fecha_publicacion

Repeats of the same lookup are served from cache for 1 days and don't count against your plan.

Status codes

200 OK
Lookup resolved. Counts one request against the plan.
401 Invalid or expired token
The authentication header is missing or the token isn't valid.
403 No access
The plan doesn't cover this service, or the subscription isn't active.
404 Not found
The lookup ran but returned nothing. It still counts.
429 Limit reached
The period's lookups have run out.
500 Service error
The official source failed to answer. Nothing is cached.