Ayudas de mínimis por NIF
Ayudas de mínimis por NIF
POST https://api.fandit.es/api/v2/fund-minimis-by-nif/
Petición para obtener todas las concesiones sujetas al reglamento de mínimis de un NIF concreto. La respuesta es un array sin paginar.
Sirve para saber cuánto de mínimis ha recibido ya una empresa. Si el NIF no tiene concesiones devuelve 200 con un array vacío: es el único caso que significa «sin mínimis registrados».
Antes de consultar BDNS se valida el NIF: formato, longitud y dígito o letra de control de DNI, NIE (X/Y/Z), NIF K/L/M y CIF. Los errores devuelven un objeto con error (mensaje legible, puede cambiar) y code (estable): decide según code, no según el texto.
400 nif_required: no se envía el NIF («El NIF es requerido»). 400 invalid_nif: formato, longitud o dígito de control inválido, p. ej. «El dígito de control del NIF es inválido» (el texto varía según el fallo). Es un error del usuario: pide que revise el NIF y nunca lo muestres como «Total: 0» ni calcules el margen de mínimis.
Cada concesión incluye concession_id (identificador único de la concesión en BDNS), concession_code (código público, p. ej. SB137062769), registration_date (fecha de registro en BDNS) e instrument (tipo de ayuda: subvención, préstamo, garantía…). Usa concession_id para no contar duplicados al sumar el total de mínimis: dos filas con el mismo concession_id son la misma concesión y cuentan una vez; con ids distintos son concesiones reales y cuentan todas, aunque coincidan convocatoria, fecha e importe. concession_amount es la ayuda equivalente concedida, también en préstamos y garantías. Si BDNS no envía algún campo, sale null.
Si BDNS (infosubvenciones.es) no responde, tarda más de 15 s, devuelve un error HTTP o una respuesta que no es JSON, devuelve 502 con el error «No se ha podido consultar BDNS, inténtalo más tarde» y code bdns_unavailable. Es un fallo temporal del servicio externo, no significa que el NIF no tenga ayudas de mínimis: reintenta más tarde y no lo trates como un array vacío. En el peor caso la respuesta puede tardar unos 30 s, así que usa un timeout de cliente mayor.
Cabeceras
| Authorization string | |
|---|---|
| Token de usuario (Obligatorio). |
Parámetros del cuerpo (body params)
Respuesta
Array of objects
bdns string | null
organs string | null
minimis string | null
concession_date string | null
activity string | null
concession_amount number | null
concession_id number | null
concession_code string | null
registration_date string | null
instrument string | null
curl--request POST \--url 'https://api.fandit.es/api/v2/fund-minimis-by-nif/' \ import requests
url = "https://api.fandit.es/api/v2/fund-minimis-by-nif/"
response = requests.post(url)
print(response.status_code)
print(response.json())
const url = "https://api.fandit.es/api/v2/fund-minimis-by-nif/";
const options = {
method: "POST",
headers: {
}
};
const response = await fetch(url, options);
const data = await response.json();
console.log(data);
const url: string = "https://api.fandit.es/api/v2/fund-minimis-by-nif/";
const options: RequestInit = {
method: "POST",
headers: {
}
};
const response = await fetch(url, options);
const data: any = await response.json();
console.log(data);
<?php
$url = "https://api.fandit.es/api/v2/fund-minimis-by-nif/";
$curl = curl_init($url);
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
]
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;
import java.io.IOException;
import okhttp3.*;
public class FanditApiExample {
public static void main(String[] args) throws IOException {
OkHttpClient client = new OkHttpClient();
String url = "https://api.fandit.es/api/v2/fund-minimis-by-nif/";
Request request = new Request.Builder()
.url(url)
.post()
.build();
try (Response response = client.newCall(request).execute()) {
System.out.println(response.body().string());
}
}
}
Respuesta Ejemplo de respuesta
[
{
"bdns": "787822",
"organs": "ESTADO MINISTERIO DE INDUSTRIA Y TURISMO FUNDACIÓN EOI, F.S.P.",
"minimis": "REG (UE) 2023/2831 de minimis, General",
"concession_date": "2025-05-12",
"activity": "62 - Programación, consultoría y otras actividades relacionadas con la informática",
"concession_amount": 9500,
"concession_id": 118734521,
"concession_code": "SB118734521",
"registration_date": "2025-05-20",
"instrument": "SUBVENCIÓN y ENTREGA DINERARIA SIN CONTRAPRESTACIÓN"
},
{
"bdns": "748908",
"organs": "LOCAL MADRID ÁREA DE GOBIERNO DE ECONOMÍA, INNOVACIÓN Y HACIENDA",
"minimis": "REG (UE) 2023/2831 de minimis, General",
"concession_date": "2024-12-10",
"activity": "H - TRANSPORTE Y ALMACENAMIENTO; T - OTROS SERVICIOS",
"concession_amount": 50000,
"concession_id": 104562387,
"concession_code": "SB104562387",
"registration_date": "2024-12-18",
"instrument": "SUBVENCIÓN y ENTREGA DINERARIA SIN CONTRAPRESTACIÓN"
}
]