Skip to main content
POST
/
api
/
rues
/
companies
/
search
/rues/companies/search
curl --request POST \
  --url https://api.anysite.io/api/rues/companies/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "query": "<string>",
  "count": 2,
  "timeout": 300,
  "search_by": "name",
  "status": [],
  "category": []
}
'
[
  {
    "id": "<string>",
    "name": "<string>",
    "@type": "@rues_search_result",
    "sigla": "<string>",
    "registration_number": "<string>",
    "nit": "<string>",
    "identification_number": "<string>",
    "dv": "<string>",
    "chamber_code": "<string>",
    "chamber": "<string>",
    "department": "<string>",
    "municipality": "<string>",
    "company_type_code": "<string>",
    "company_type": "<string>",
    "legal_organization": "<string>",
    "registration_category": "<string>",
    "status": "<string>",
    "ciiu_primary_code": "<string>",
    "ciiu_secondary_code": "<string>",
    "registration_date": "<string>",
    "updated_at": "<string>",
    "proponent_registration": "<string>",
    "is_lottery_seller": false
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
query
string
required

Company name or identification number to search

Minimum string length: 1
Example:

"bancolombia"

count
integer
required

Max number of results

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
search_by
enum<string>
default:name

Search the query as a company name or as an identification number

Available options:
name,
identification
status
enum<string>[] | null

Filter by registration status

Available options:
ACTIVA,
CANCELADA
category
enum<string>[] | null

Filter by registration category

Available options:
JURIDICA,
NATURAL,
COMERCIO,
SUCURSAL,
AGENCIA

Response

Successful Response

id
string
required
name
string
required
@type
string
default:@rues_search_result
sigla
string | null
registration_number
string | null
nit
string | null
identification_number
string | null
dv
string | null
chamber_code
string | null
chamber
string | null
department
string | null
municipality
string | null
company_type_code
string | null
company_type
string | null
registration_category
string | null
status
string | null
ciiu_primary_code
string | null
ciiu_secondary_code
string | null
registration_date
string | null
updated_at
string | null
proponent_registration
string | null
is_lottery_seller
boolean
default:false