> ## Documentation Index > Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt > Use this file to discover all available pages before exploring further. # INVIMA > Busque cada registro sanitário que o INVIMA emitiu ou deixou vencer, em todos os grupos de produtos, e cada apresentação de medicamento registrada com seu código CUM, ATC e princípios ativos. O Instituto Nacional de Vigilancia de Medicamentos y Alimentos (INVIMA) é a autoridade sanitária da Colômbia. Nada do que regula pode ser vendido no país sem seu registro sanitário ou, para cosméticos e produtos de limpeza de baixo risco, sua notificação sanitária obrigatória (NSO): medicamentos, alimentos e bebidas, cosméticos, dispositivos médicos, reagentes de diagnóstico, suplementos, biológicos, homeopáticos e fitoterápicos, produtos odontológicos e pesticidas. Este é o registro completo, cerca de 385.000 registros vigentes ou vencidos, cada um com seu número, datas, titular, todos os nomes de produto que ampara e cada empresa ou pessoa com um papel nele. Para medicamentos desce um nível: cada apresentação comercial, cerca de 163.000, com seu código CUM (Código Único de Medicamento), código ATC, forma farmacêutica, princípios ativos e concentração, via, embalagem e se está ativa. Busque registros por produto, número, titular, grupo, situação ou vencimento; busque medicamentos por princípio ativo, código ATC, nome ou titular; depois leia um registro pelo seu expediente ou uma apresentação pelo seu CUM. A fonte inteira, organizada e pronta para consultar: cada endpoint desta página responde em milissegundos. Cada resposta traz `as_of`: o quão atuais são os dados. [Como funcionam os datasets](/pt/datasets). ## Buscar registros sanitários `POST /co/invima/registrations-search/v1` Dataset Uma única busca sobre cada registro e notificação, em todos os grupos de produtos, por produto, número, titular, grupo, situação ou vencimento. | Campo | Tipo | Notas | | - | - | - | | `query` | string | Palavras opcionais buscadas nos nomes de produto, no titular e em cada empresa ou pessoa com um papel. | | `registration_number` | string | Número opcional de registro ou notificação em qualquer grafia, p. ex. `INVIMA 2020M-0019848`, `2020M-0019848` ou `NSO-PC-C 32.233 -VE`. Espaços, hifens, pontos e maiúsculas são ignorados. | | `holder` | string | Titular opcional, comparado desde o início. Maiúsculas e acentos são ignorados. | | `product_group` | string | Grupo opcional como o INVIMA o nomeia: `MEDICAMENTOS`, `ALIMENTOS`, `COSMETICOS`, `MEDICO QUIRURGICOS`, `REACTIVO DIAGNOSTICO`, `REACTIVOS IN VITRO`, `BEBIDAS ALCOHOLICAS`, `ASEO Y LIMPIEZA`, `SUPLEMENTO DIETARIO`, `BIOLOGICOS`, `HOMEOPATICOS`, `FITOTERAPEUTICO`, `ODONTOLOGICOS` ou `PLAGUICIDAS`. | | `status` | string | Situação opcional: `vigente` (em vigor) ou `vencido` (expirado). | | `expires_from` | string | Opcional: só registros que vencem nesta data ou depois, `yyyy-mm-dd`. | | `expires_to` | string | Opcional: só registros que vencem nesta data ou antes, `yyyy-mm-dd`. | | `page` | integer | Número da página, começa em 1. Por padrão `1`. | | `per_page` | integer | Resultados por página (1-100). Por padrão `20`. | ```bash theme={"dark"} curl https://api.croma.run/co/invima/registrations-search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "acetaminofen", "product_group": "MEDICAMENTOS", "status": "vigente" }' ``` Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`, do vencimento mais distante ao mais antigo. Cada registro traz `id` (o número de expediente do INVIMA), `registration_number` (como o INVIMA o escreve, p. ex. `INVIMA 2020M-0019848`), `product` e `products` (todos os nomes de produto que ampara), `product_group` (p. ex. `MEDICAMENTOS`, `ALIMENTOS`, `COSMETICOS`, `MEDICO QUIRURGICOS`), `directorate`, `status` (`Vigente` ou `Vencido`), `issued_at`, `expires_at`, `holder`, `modality` (p. ex. `FABRICAR Y VENDER`), `risk_level` (dispositivos e reagentes), `uses`, `shelf_life`, `parties[]` (`role` e `name`: fabricantes, importadores, acondicionadores, procuradores, representantes legais, farmacêuticos) e `entries`. ## Um registro `POST /co/invima/registration/v1` Dataset | Campo | Tipo | Notas | | - | - | - | | `file_number` | string | **Obrigatório.** O número de expediente do INVIMA, o `id` de um resultado de busca, p. ex. `20190868`. | ```bash theme={"dark"} curl https://api.croma.run/co/invima/registration/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "file_number": "20190868" }' ``` Retorna `as_of`, `found`, `file_number` e `registration`. Cada registro traz `id` (o número de expediente do INVIMA), `registration_number` (como o INVIMA o escreve, p. ex. `INVIMA 2020M-0019848`), `product` e `products` (todos os nomes de produto que ampara), `product_group` (p. ex. `MEDICAMENTOS`, `ALIMENTOS`, `COSMETICOS`, `MEDICO QUIRURGICOS`), `directorate`, `status` (`Vigente` ou `Vencido`), `issued_at`, `expires_at`, `holder`, `modality` (p. ex. `FABRICAR Y VENDER`), `risk_level` (dispositivos e reagentes), `uses`, `shelf_life`, `parties[]` (`role` e `name`: fabricantes, importadores, acondicionadores, procuradores, representantes legais, farmacêuticos) e `entries`. Um número sob o qual o INVIMA não lista nada retorna `found: false` com HTTP 200, não um erro. ## Buscar medicamentos `POST /co/invima/medicines-search/v1` Dataset Uma única busca sobre cada apresentação de medicamento registrada, por princípio ativo, código ATC, nome, número, titular ou situação. | Campo | Tipo | Notas | | - | - | - | | `query` | string | Palavras opcionais buscadas no nome do medicamento, seus princípios ativos, o titular e a descrição ATC. | | `registration_number` | string | Número de registro opcional em qualquer grafia, p. ex. `INVIMA 2023M-0013598-R2`. Espaços, hifens e maiúsculas são ignorados. | | `file_number` | string | Expediente opcional do INVIMA, p. ex. `20042480`: todas as apresentações desse registro. | | `active_ingredient` | string | Princípio ativo opcional como o INVIMA o nomeia, p. ex. `ACETAMINOFEN` ou `AMOXICILINA TRIHIDRATO`. Correspondência exata; maiúsculas e acentos são ignorados. | | `atc_code` | string | Código ATC opcional ou seu prefixo, p. ex. `N02BE01` para uma substância ou `N02` para um grupo inteiro. | | `holder` | string | Titular opcional, comparado desde o início. Maiúsculas e acentos são ignorados. | | `status` | string | Situação opcional do registro como o INVIMA a escreve: `vigente`, `vencido`, `perdida fuerza ejec`, `cancelado`, `negado`, `suspendido`, `en tramite renov`, entre outras. Maiúsculas e acentos são ignorados. | | `cum_status` | enum | Situação opcional da apresentação: `activo` ou `inactivo`. | | `expires_from` | string | Opcional: só registros que vencem nesta data ou depois, `yyyy-mm-dd`. | | `expires_to` | string | Opcional: só registros que vencem nesta data ou antes, `yyyy-mm-dd`. | | `page` | integer | Número da página, começa em 1. Por padrão `1`. | | `per_page` | integer | Resultados por página (1-100). Por padrão `20`. | ```bash theme={"dark"} curl https://api.croma.run/co/invima/medicines-search/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "active_ingredient": "ACETAMINOFEN", "status": "vigente", "cum_status": "activo" }' ``` Retorna `as_of` (o quão atuais são os dados), os filtros aplicados, `total` e `total_is_exact`, `page`, `per_page`, `total_pages`, `count` e `results[]`, da apresentação ativada mais recentemente à mais antiga. Cada apresentação traz `id` (o código CUM, p. ex. `20042480-41`), `file_number` e `cum_sequence` (suas duas metades), `registration_number`, `product`, `holder`, `status` (o do registro: `Vigente`, `Vencido`, `Perdida Fuerza Ejec`, `Cancelado`, `Negado`, `Suspendido`, `En tramite renov` e outros), `cum_status` (`activo` ou `inactivo`), `issued_at`, `expires_at`, `cum_active_since`, `cum_inactive_since`, `commercial_description`, `pack_quantity`, `pack_unit`, `medical_sample`, `atc_code`, `atc_description`, `pharmaceutical_form`, `administration_routes[]`, `active_ingredients[]` (`name`, `quantity`, `unit`, `reference_unit`), `parties[]` (`role` e `name`), `modality`, `ium` e `entries`. ## Uma apresentação `POST /co/invima/medicine/v1` Dataset | Campo | Tipo | Notas | | - | - | - | | `cum` | string | **Obrigatório.** O código CUM, o `id` de um resultado de busca: o expediente e o sequencial unidos por um hífen, p. ex. `20042480-41`. | ```bash theme={"dark"} curl https://api.croma.run/co/invima/medicine/v1 \ -H "Authorization: Bearer $CROMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "cum": "20042480-41" }' ``` Retorna `as_of`, `found`, `cum` e `medicine`. Cada apresentação traz `id` (o código CUM, p. ex. `20042480-41`), `file_number` e `cum_sequence` (suas duas metades), `registration_number`, `product`, `holder`, `status` (o do registro: `Vigente`, `Vencido`, `Perdida Fuerza Ejec`, `Cancelado`, `Negado`, `Suspendido`, `En tramite renov` e outros), `cum_status` (`activo` ou `inactivo`), `issued_at`, `expires_at`, `cum_active_since`, `cum_inactive_since`, `commercial_description`, `pack_quantity`, `pack_unit`, `medical_sample`, `atc_code`, `atc_description`, `pharmaceutical_form`, `administration_routes[]`, `active_ingredients[]` (`name`, `quantity`, `unit`, `reference_unit`), `parties[]` (`role` e `name`), `modality`, `ium` e `entries`. Um número sob o qual o INVIMA não lista nada retorna `found: false` com HTTP 200, não um erro. Esquemas, todos os campos de resposta e um playground interativo. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.