Skip to main content
POST
/
auth
/
onboarding
/
ruc-validate
Validate Ruc
curl --request POST \
  --url http://localhost:8000/auth/onboarding/ruc-validate \
  --header 'Content-Type: application/json' \
  --data '
{
  "ruc": "<string>",
  "onboarding_ticket": "<string>"
}
'
{
  "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": {}
    }
  ]
}

Body

application/json
ruc
string
required

RUC to validate against SRI

Pattern: ^\d{13}$
onboarding_ticket
string
required

Short-lived onboarding ticket to validate session

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