DIAN Importers and Exporters

Every year the Dirección de Impuestos y Aduanas Nacionales (DIAN) publishes two directories: the importers and the exporters of goods. Each ranks the companies that traded that year by value, with the CIF value of their imports or the FOB value of their exports in US dollars, the net weight, how many declarations they filed, and the five subpartidas arancelarias they traded most. The directories start in 2017, and the current year’s grows as months close. Croma serves every year of both directories in one search, and a company’s whole trade history by NIT.

The whole source, organized and ready to query: every endpoint on this page answers in milliseconds. Every response carries as_of: how current the data is. How datasets work.

Search the directories

POST /co/dian-trade/directory-search/v1 Dataset Every year of both directories in one search: by name, flow, year and tariff code.

Field	Type	Notes
`query`	string	Optional words matched against the name (razón social) as DIAN prints it.
`flow`	enum	Which directory: `import` (importers, valued CIF), `export` (exporters, valued FOB), or `any`. Default `any`.
`year`	integer	Optional directory year (2017 or later). 0 searches every year. Default `0`.
`tariff_code`	string	Optional tariff code, digits only, matched against the five main subpartidas of each row: a 4-digit heading (`8703`), a 6-digit HS subheading (`870323`) or a full 10-digit subpartida (`8703239090`).
`page`	integer	1-based page number for paginated results. Default `1`.
`per_page`	integer	Results per page (1-100). Default `20`.

curl https://api.croma.run/co/dian-trade/directory-search/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "flow": "import", "year": 2025, "tariff_code": "8703" }'

Returns as_of (how current the data is), the applied filters, total (matches across every page), page, per_page, total_pages, count and results[]: one company’s row in one year’s directory each, newest year first, then by value, largest first.

Field	Notes
`id`	The row’s identifier: flow, year and NIT (`import-2025-899999068`), or flow, year and rank for a natural person (`import-2025-pn-34409`).
`flow`	`import` (the importers directory) or `export` (the exporters directory).
`year`, `through_month`	The directory’s year and the last month its figures accumulate to: `12` for a closed year, earlier for the current year, whose directory grows as months close.
`rank`	Position in that year’s directory, `1` for the largest value.
`document_number`	The company’s NIT, no verification digit. `null` for a natural person.
`name`	Razón social as DIAN prints it that year.
`natural_person`	`true` when DIAN publishes the row without identification: `name` reads `PERSONA NATURAL` and `document_number` is `null`.
`value_usd`, `value_basis`	The year’s value in US dollars: `CIF` for imports, `FOB` for exports.
`net_weight_kg`	Net weight in kilograms.
`declarations`	Imports: the number of import declarations filed. `null` on exports.
`declaration_items`	Exports: the number of items (series) across the export declarations, which is not the number of declarations. `null` on imports.
`top_tariff_codes[]`	Up to five 10-digit subpartidas arancelarias, main first. `top_tariff_headings[]` (4 digits) and `top_tariff_subheadings[]` (6 digits) are the same codes cut to heading and HS subheading.
`updated_at`	The date DIAN last updated that year’s directory.

DIAN publishes natural persons without their identification or name, as PERSONA NATURAL; those rows are here with their figures, marked natural_person: true, and no NIT finds them. The current year’s directory accumulates as months close (through_month says to when), and DIAN also revises past years, so a company’s figures for a year can change.

Company trade profile

POST /co/dian-trade/profile/v1 Dataset Every year a company imported or exported, from its NIT.

Field	Type	Notes
`document_number`	string	Required. The company’s Colombian NIT, numeric, no verification digit. 4-15 digits.

curl https://api.croma.run/co/dian-trade/profile/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "document_number": "899999068" }'

Returns as_of, found, document_number, name (as the most recent directory prints it), years[] (every year the company appears in either directory, newest first), imports[] and exports[]: the company’s row in each year’s importers and exporters directory, newest first, with the same fields as a search result.

A NIT that appears in no directory since 2017 returns found: false with HTTP 200, not an error. A company that only imports has an empty exports, and the other way around.

Full reference

Schemas, all response fields, and an interactive playground.

Get Started

Request types

Countries

DIAN Importers and Exporters

Search the directories

Company trade profile

Full reference

​Search the directories

​Company trade profile

Full reference

Search the directories

Company trade profile