Skip to main content
GET
/
issuers
/
lookup
/
ruc
Lookup Issuer Taxpayer
curl --request GET \
  --url http://localhost:8000/issuers/lookup/ruc
{
  "valid": true,
  "ruc": "<string>",
  "legal_name": "<string>",
  "trade_name": "<string>",
  "address": "<string>",
  "contributor_status": "<string>",
  "contributor_type": "<string>",
  "legal_representative_name": "<string>",
  "sri_data": {},
  "error": "<string>",
  "establishments": [
    {
      "number": "<string>",
      "is_matrix": true,
      "type": "<string>",
      "name": "<string>",
      "address": "<string>",
      "status": "<string>",
      "sri_data": {}
    }
  ]
}

Headers

authorization
string | null
x-api-key
string | null
x-tenant-id
string | null

Query Parameters

ruc
string
required

RUC del emisor

Pattern: ^\d{13}$

Cookies

factio_access_token
string | null

Response

Successful Response

valid
boolean
required

Whether the RUC was found and is active

source
enum<string>
required

Lookup source

Available options:
sri_cache,
sri_live,
not_found
ruc
string
required

The validated RUC

Razón social from SRI

trade_name
string | null

Nombre comercial from SRI

address
string | null

DirecciónCompleta from SRI

contributor_status
string | null

EstadoContribuyenteRuc from SRI

contributor_type
string | null

TipoContribuyente from SRI

Primer representante legal del contribuyente

sri_data
Sri Data · object

Raw payload returned by SRI catastro

error
string | null

Error code if validation failed: not_found, inactive, sri_unavailable

establishments
IssuerLookupEstablishmentResponse · object[]

Establecimientos asociados al RUC