---
title: "Resolver un nombre de empresa a su NIF"
method: GET
path: "/empresas"
tags: ["Empresas"]
---

# Resolver un nombre de empresa a su NIF

`GET /empresas`

## Request

- Base URL: `https://boletinclaro.es/v1`
- URL: `https://boletinclaro.es/v1/empresas`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Busca por coincidencia parcial del nombre y devuelve el NIF con cuánto dinero público lleva recibido cada candidata. El paso previo a pedir su perfil.

## Query parameters

- `consulta` string, required

## Response `200`

Empresas que coinciden, de más a menos dinero público.

- RespuestaEmpresas: Envoltorio común de las respuestas de lista. No hay paginación: una búsqueda semántica ordena por parecido, y la fila 400 de un ranking así no significa nada.
  - `busqueda` SearchMetadata
    - `candidatos_leidos` integer, required
    - `grupos_consulta` integer, required
    - `limite_candidatos` integer, required
    - `truncada` boolean, required: La selección de candidatos o el resultado se recortó; no es una exportación exhaustiva.
  - `consulta` string: La consulta tal y como se aplicó, ya recortada si venía por encima del máximo.
  - `resultados` EmpresaResumen[], required: Empresas que coinciden con el nombre.
    - `alcance_total` 'BDNS,PLACSP', required
    - `consultado_en` string, date-time: Instante de consulta de agregados que originó esta caché. No es la fecha de actualización de las fuentes.
    - `dinero_publico_nacional_total` number, required: BDNS más PLACSP, comparable con el mismo campo del detalle teniendo en cuenta la fecha de caché.
    - `dinero_publico_total` number, double, required: Suma de subvenciones y contratos.
    - `importe_contratos` number, double
    - `importe_subvenciones` number, double
    - `nif` string, required
    - `nombre` string, required
    - `num_contratos` integer
    - `num_subvenciones` integer
  - `total` integer, required: Cuántas filas trae ESTA respuesta. No es cuántas hay en total.

## Other responses

- `400`: Un parámetro no vale.
- `401`: La clave de API no existe o está revocada.
- `403`: El plan del espacio de trabajo no incluye acceso a la API.
- `405`: La ruta existe pero no admite ese método HTTP.
- `429`: Has superado la ráfaga, el saldo mensual o diario del workspace, el tope por usuario o el máximo de perfiles y fichas.
- `500`: Fallo nuestro.
- `503`: Algo nuestro no está disponible. Incluye el caso en que no se pudo resolver «zona»: preferimos fallar a devolverte resultados sin filtrar.

---

[API](https://skmtc.dev/boletinclaro/apis/api-de-boletin-claro.md) · [All operations](https://skmtc.dev/boletinclaro/apis/api-de-boletin-claro/llms.txt) · [OpenAPI document](https://skmtc.dev/boletinclaro/apis/api-de-boletin-claro/revisions/0a0d93c76a75?raw)