Skip to main content
GET
/
buyers
/
lookup
Look up a buyer by RUC or cédula
curl --request GET \
  --url http://localhost:8000/buyers/lookup
{
  "found": true,
  "is_frequent": true,
  "buyer": {
    "id": "<string>",
    "id_type": "<string>",
    "legal_name": "<string>",
    "trade_name": "<string>",
    "contributor_status": "<string>",
    "contributor_type": "<string>",
    "address": "<string>"
  }
}

Headers

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

Query Parameters

id
string
required

RUC or cédula number

id_type
string
required

Type of identifier: ruc or cedula

Cookies

factio_access_token
string | null

Response

Successful Response

found
boolean
required
source
enum<string>
required
Available options:
tenant_profile,
sri_cache,
sri_live,
not_found
is_frequent
boolean
required
buyer
BuyerData · object
required