---
title: "Dinero público recibido por una empresa"
method: GET
path: "/empresas/{nif}"
tags: ["Empresas"]
---

# Dinero público recibido por una empresa

`GET /empresas/{nif}`

## Request

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

Subvenciones y contratos de una empresa, con totales, rango de fechas, organismos y sectores principales, y el reparto por año.

Un NIF sin registros devuelve `404`, no una respuesta vacía.

## Path parameters

- `nif` string, required

## Response `200`

El perfil de dinero público de la empresa.

- Empresa: El perfil de dinero público de una empresa: identidad, totales y agregados. Todavía **no** incluye el detalle línea a línea de cada subvención y cada contrato, los datos mercantiles del BORME. Incluye el desglose agregado CORDIS y TED transfronterizo. El total nacional permite comparar BDNS+PLACSP; la búsqueda y el snapshot pueden tener distinta antigüedad. materializado_en y consultado_en son tiempos de caché, no fechas de actualización en origen.
  - `alcance_agregados` 'BDNS', required: Fuente de organismos, sectores y reparto anual.
  - `alcance_total` 'BDNS,PLACSP,CORDIS,TED_TRANSFRONTERIZO', required
  - `contratos` BloqueImportes, required: Recuento, dinero y rango de fechas de un canal de financiación.
    - `importe` number, double, required
    - `numero` integer, required
    - `primera` string, date
    - `ultima` string, date
  - `contratos_ue_transfronterizos` BloqueImportes, required: Recuento, dinero y rango de fechas de un canal de financiación.
    - `importe` number, double, required
    - `numero` integer, required
    - `primera` string, date
    - `ultima` string, date
  - `datos_parciales` boolean, required: Alguna fuente no pudo consultarse; los totales pueden estar incompletos.
  - `dinero_publico_nacional_total` number, required: Suma de subvenciones BDNS y contratos PLACSP del snapshot.
  - `dinero_publico_total` number, double, required
  - `ficha` string, uri
  - `importes_por_anio` AgregadoAnio[]: Reparto de subvenciones BDNS por año; no incluye contratos ni fondos europeos.
    - `anio` integer, required
    - `importe` number, double, required
    - `numero` integer, required
  - `materializado_en` string, date-time: Instante de ensamblado del snapshot; puede conservarse hasta siete días. No es fecha de actualización de las fuentes.
  - `nif` string, required
  - `nombre` string, required
  - `organismos_principales` AgregadoOrganismo[]: Organismos BDNS de los que más subvenciones ha recibido.
    - `importe` number, double, required
    - `numero` integer, required
    - `organismo` string, required
  - `proyectos_europeos` BloqueImportes, required: Recuento, dinero y rango de fechas de un canal de financiación.
    - `importe` number, double, required
    - `numero` integer, required
    - `primera` string, date
    - `ultima` string, date
  - `sectores_principales` AgregadoSector[]: Sectores BDNS en los que más subvenciones ha recibido.
    - `codigo` string
    - `descripcion` string
    - `importe` number, double, required
  - `snapshot_caducado` boolean, required: Se sirve una copia fuera de su ventana de frescura ante un fallo del servicio de datos.
  - `subvenciones` BloqueImportes, required: Recuento, dinero y rango de fechas de un canal de financiación.
    - `importe` number, double, required
    - `numero` integer, required
    - `primera` string, date
    - `ultima` string, date

## 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.
- `404`: No hay registros para lo pedido, o la ruta no existe.
- `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)
