---
title: "Prellenado del comprador por RUC/cédula"
method: GET
path: "/clientes/lookup/{identificacion}"
tags: ["catalogos"]
---

# Prellenado del comprador por RUC/cédula

`GET /clientes/lookup/{identificacion}`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/clientes/lookup/{identificacion}`
- Auth: HTTP bearer

Busca primero en el directorio de clientes (devuelve también email/teléfono) y, si no está, en el catastro público del SRI. Para cédula (`tipo=05`) consulta el RUC de persona natural (cédula+`001`). `advertencias` avisa de RUC suspendido/fantasma (informativo).

## Path parameters

- `identificacion` string, required

## Query parameters

- `tipo` '04' | '05', required

## Response `200`

Datos para prellenar

- ClienteLookup
  - `fuente` 'directorio' | 'sri', required
  - `tipoIdentificacion` string
  - `identificacion` string
  - `razonSocial` string, required
  - `direccion` string
  - `email` string: Solo fuente=directorio (no es público en el SRI)
  - `telefono` string: Solo fuente=directorio
  - `estadoSri` string
  - `regimen` string
  - `advertencias` string[]
  - `diasCredito` integer: Días de crédito de la ficha

## Other responses

- `400`: Cuerpo inválido o validación de negocio (previene errores SRI 62/52/65/69/39)
- `404`: Sin datos (ni directorio ni SRI)
- `503`: Catastro del SRI no disponible - tratar como "sin prellenado"

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)