{
"openapi": "3.0.1",
"info": {
"title": "Colombia NIT Lookup - RUES Company Registry Search",
"description": "Consulta NIT Colombia: look up Colombian companies by NIT or search the official RUES registry (Confecámaras, 9M+ records) by name, chamber of commerce, CIIU, legal form and registration date. Status, legal representative, establishments. No API key. $1.50 per 1,000 results.",
"version": "0.1",
"x-build-id": "Zk2BPY7jMiFDjhHQo"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/1rrock~colombia-nit-lookup/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-1rrock-colombia-nit-lookup",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/1rrock~colombia-nit-lookup/runs": {
"post": {
"operationId": "runs-sync-1rrock-colombia-nit-lookup",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/1rrock~colombia-nit-lookup/run-sync": {
"post": {
"operationId": "run-sync-1rrock-colombia-nit-lookup",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"properties": {
"nits": {
"title": "NITs / ID numbers",
"type": "array",
"description": "Colombian NITs (or cédula numbers of registered merchants), one per line. Dots, spaces and the check digit (e.g. 860.002.964-4) are accepted. Each registration found produces one result; numbers not found produce an ok: false row. If this and all search filters are empty, three demo companies are looked up.",
"items": {
"type": "string"
}
},
"name": {
"title": "Company name search (razón social)",
"type": "string",
"description": "Words that must all appear in the registered name (razón social), e.g. rappi or constructora medellin. Case-insensitive. Can be combined with the filters below."
},
"chambers": {
"title": "Chamber of commerce (cámara de comercio)",
"type": "array",
"description": "Only registrations in these chambers of commerce (e.g. 04 Bogotá, 21 Medellín, 08 Cali, 03 Barranquilla). Leave empty for all of Colombia.",
"items": {
"type": "string",
"enum": [
"01",
"02",
"03",
"04",
"05",
"06",
"07",
"08",
"09",
"10",
"11",
"12",
"13",
"14",
"15",
"16",
"17",
"18",
"19",
"20",
"21",
"22",
"23",
"24",
"25",
"26",
"27",
"28",
"29",
"30",
"31",
"32",
"33",
"34",
"35",
"36",
"37",
"38",
"39",
"40",
"41",
"42",
"43",
"44",
"45",
"46",
"47",
"48",
"49",
"50",
"51",
"52",
"53",
"54",
"55",
"56",
"57",
"58"
],
"enumTitles": [
"01 - Armenia",
"02 - Barrancabermeja",
"03 - Barranquilla",
"04 - Bogotá",
"05 - Bucaramanga",
"06 - Buenaventura",
"07 - Buga",
"08 - Cali",
"09 - Cartagena",
"10 - Cartago",
"11 - Cúcuta",
"12 - Chinchiná",
"13 - Duitama",
"14 - Girardot",
"15 - Honda",
"16 - Ibagué",
"17 - Ipiales",
"18 - La Dorada",
"19 - Magangué",
"20 - Manizales",
"21 - Medellín (Antioquia)",
"22 - Montería",
"23 - Huila",
"24 - Palmira",
"25 - Pamplona",
"26 - Pasto",
"27 - Pereira",
"28 - Cauca",
"29 - Chocó",
"30 - La Guajira",
"31 - San Andrés",
"32 - Santa Marta (Magdalena)",
"33 - Santa Rosa de Cabal",
"34 - Sincelejo",
"35 - Sogamoso",
"36 - Tuluá",
"37 - Tumaco",
"38 - Tunja",
"39 - Valledupar",
"40 - Villavicencio",
"41 - Florencia (Caquetá)",
"42 - Amazonas",
"43 - Sevilla",
"44 - Urabá",
"45 - Sur y Oriente Del Tolima",
"46 - Putumayo",
"47 - Facatativá",
"48 - Arauca",
"49 - Ocaña",
"50 - Casanare",
"51 - Oriente Antioqueño",
"52 - Magdalena Medio",
"53 - Aguachica",
"54 - Dosquebradas",
"55 - Aburrá Sur",
"56 - Piedemonte Araucano",
"57 - San José",
"58 - Soacha"
]
}
},
"status": {
"title": "Registration status",
"enum": [
"any",
"active",
"cancelled"
],
"type": "string",
"description": "Status filter for searches. NIT lookups always return every registration of the number (active first).",
"default": "any"
},
"entityType": {
"title": "Entity type",
"enum": [
"any",
"legal",
"natural"
],
"type": "string",
"description": "Restrict searches to legal entities or to registered individual merchants.",
"default": "any"
},
"legalForms": {
"title": "Legal form",
"type": "array",
"description": "Only these legal forms (organización jurídica), e.g. SAS. Leave empty for all.",
"items": {
"type": "string",
"enum": [
"sas",
"ltda",
"sa",
"unipersonal",
"scs",
"sca",
"colectiva",
"extranjera",
"cooperativa",
"eat",
"otras",
"persona_natural"
],
"enumTitles": [
"SAS - Sociedad por Acciones Simplificada",
"Ltda. - Sociedad Limitada",
"S.A. - Sociedad Anónima",
"Empresa Unipersonal",
"Sociedad en Comandita Simple",
"Sociedad en Comandita por Acciones",
"Sociedad Colectiva",
"Sociedad Extranjera (foreign branch)",
"Cooperativa (entidad de naturaleza cooperativa)",
"Empresa Asociativa de Trabajo",
"Otras sociedades",
"Persona natural (sole trader)"
]
}
},
"ciiuCodes": {
"title": "CIIU activity codes",
"type": "array",
"description": "CIIU Rev. 4 A.C. codes. A 4-digit code matches exactly (e.g. 6201 software development); 1-3 digits match as a prefix (e.g. 62 = all IT services, 47 = retail).",
"items": {
"type": "string"
}
},
"matchSecondaryCiiu": {
"title": "Also match secondary activities",
"type": "boolean",
"description": "Match the CIIU codes against secondary activities too (not only the main activity).",
"default": false
},
"registeredWithinDays": {
"title": "Registered in the last N days",
"minimum": 1,
"maximum": 3650,
"type": "integer",
"description": "New companies only: registration date (fecha de matrícula) within the last N days. Great for scheduled new-business lead feeds. RUES open data is refreshed by Confecámaras roughly weekly."
},
"registeredFrom": {
"title": "Registered from (date)",
"type": "string",
"description": "Registration date from (inclusive), YYYY-MM-DD."
},
"registeredTo": {
"title": "Registered to (date)",
"type": "string",
"description": "Registration date to (inclusive), YYYY-MM-DD."
},
"renewedSince": {
"title": "Renewed since year",
"minimum": 1990,
"maximum": 2100,
"type": "integer",
"description": "Only registrations whose last renewal year (último año renovado) is this year or later, e.g. 2025, a good proxy for companies that are still operating."
},
"sortBy": {
"title": "Sort search results by",
"enum": [
"newest",
"oldest",
"name"
],
"type": "string",
"description": "Order of search results.",
"default": "newest"
},
"maxItems": {
"title": "Max results",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "Maximum number of records per run (lookups + search). This is your cost cap: each record is one result.",
"default": 100
},
"includeEstablishments": {
"title": "Include establishments & branches",
"type": "boolean",
"description": "Add the commercial establishments, branches and agencies (establecimientos, sucursales, agencias) owned by each company as a nested list. Still one result per company; it only makes the run slower.",
"default": false
},
"maxEstablishments": {
"title": "Max establishments per company",
"minimum": 1,
"maximum": 1000,
"type": "integer",
"description": "Cap on nested establishments per company (active ones first). The total count is still reported in establishmentCount.",
"default": 50
},
"appToken": {
"title": "Socrata app token (optional)",
"type": "string",
"description": "Optional free datos.gov.co / Socrata app token for higher API rate limits on very large jobs. Not needed for normal use."
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
},
"PROXY_UNBLOCKER_UNITS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}