Public contracts, tenders and grants

Data from Spanish public funds: the contracts a company has been awarded, open tenders you can bid for, and the grants and subsidies a company has received.

Base URL: https://spaincompanyapi.com/api/v1 · API key in the X-API-KEY header · Get a free API key (100 requests, no card) · Full documentation

9. Public Contracts (Business Plan Only)

Query public procurement contracts and awards associated with Spanish companies by CIF. Retrieve contracting authority details, award amounts, award dates, and official tender links.

GET /companies/contracts Business
ParameterTypeRequiredDescription
cifstringRequiredCompany CIF/NIF to query (e.g. A01001411).
pageintegerOptionalPage number to retrieve. Default: 1.
limitintegerOptionalNumber of contracts per page. Default: 20 (maximum: 100).

Success response (200 OK - Business Plan)

{
  "success": true,
  "data": {
    "cif": "A01001411",
    "company_name": "RHEINMETALL EXPAL MUNITIONS SA",
    "summary": {
      "total_contracts": 32,
      "total_amount": "617746086.47",
      "currency": "EUR",
      "by_year": [
        { "year": 2026, "contracts": 6, "amount": "48211904.10" },
        { "year": 2025, "contracts": 9, "amount": "201377410.52" }
      ]
    },
    "contracts": [
      {
        "tender_id": "https://contrataciondelestado.es/sindicacion/licitacionesPerfilContratante/20344437",
        "title": "Suministro de 27.000 granadas de mortero de 81 mm...",
        "contracting_authority": "Jefatura de Asuntos Económicos del Mando de Apoyo Logístico",
        "award_date": "2026-08-25",
        "amount": "4395320.00",
        "currency": "EUR",
        "tender_url": "https://contrataciondelestado.es/wps/poc?uri=deeplink:detalle_licitacion&idEvl=B4EkDEGFvaA%2Bk2oCbDosIw%3D%3D"
      }
    ],
    "pagination": {
      "total": 32,
      "page": 1,
      "limit": 20,
      "total_pages": 2,
      "has_more": true
    }
  }
}

Plan restricted response (403 Forbidden - Free & Pro Plans)

{
  "success": false,
  "error": "PLAN_RESTRICTION",
  "message": "El acceso a contratos públicos requiere el plan Business.",
  "upsell_opportunities": {
    "mensaje": "Esta empresa tiene 14 contratos públicos adjudicados por 2.318.400 €. Con el plan Business ves cada contrato: órgano, título, fecha, importe y enlace a la licitación.",
    "upgrade_url": "https://apiempresas.es/billing?plan=business&source=api_403_contracts",
    "contratos_detectados": 14,
    "importe_total": 2318400.0,
    "currency": "EUR",
    "ultima_adjudicacion": "2026-06-12"
  }
}

The upsell_opportunities summary is included in up to 25 403 responses per account per day; after that they only carry mensaje and upgrade_url.

9.1 Open Tenders (Business only)

Public tenders open for bids today across Spain: those on the Public Sector Procurement Platform and those of the regional platforms that publish there. For each one: title, contracting authority, province, type, procedure, amount, CPV, bid deadline, days left and a link to the notice to submit a bid. Updated daily.

Not to be confused with Public Contracts: those are awards already decided (who won what); these are tenders still accepting bids.

GET /tenders Business
ParameterTypeRequiredDescription
qstringOptionalWords in the title; all must appear (min. 3 letters). E.g. limpieza colegios.
cpvstringOptionalOne or more CPV codes or their prefix, comma-separated (up to 20). E.g. 72,48 (IT) or 90911200.
provincestringOptionalProvince of the contracting authority. Variants accepted: Bizkaia, Gerona, Baleares...
typestringOptionalsupplies, services or works.
procedurestringOptionalProcedure code: 1 open, 9 simplified open, 2 restricted, 4 negotiated with notice, 13 competitive procedure with negotiation...
min_amount / max_amountnumberOptionalAmount excluding VAT, in euros.
deadline_from / deadline_todateOptionalBid deadline between these dates (YYYY-MM-DD).
published_fromdateOptionalPublished since (YYYY-MM-DD).
cifstringOptionalCompany CIF: open tenders similar to the contracts it has already won (see below).
statusstringOptionalopen (accepting bids, default), prior_notice or all (also recently closed).
sortstringOptionaldeadline (closing soonest, default), published, amount or relevance (default with cif).
page / limitintegerOptionalPagination. limit defaults to 20, max 100.
curl "https://spaincompanyapi.com/api/v1/tenders?q=limpieza&province=Madrid&type=services" \
  -H "X-API-KEY: your_api_key"

Success response (200 OK - Business plan)

{
  "success": true,
  "data": {
    "tenders": [
      {
        "tender_id": "https://contrataciondelestado.es/sindicacion/licitacionesPerfilContratante/20705710",
        "file_number": "002317/2026",
        "title": "Servicio de Mantenimiento de la Red de Comunicaciones, Telefonía IP y Cableado.",
        "status": "open",
        "contracting_authority": {
          "name": "Comité de Dirección de Equipos Nucleares S.A.",
          "nif": "A28325520",
          "city": "Maliaño",
          "province": "Cantabria"
        },
        "contract_type": "services",
        "procedure": "Abierto",
        "procedure_code": "1",
        "amount_excl_vat": 48000,
        "amount_incl_vat": 58080,
        "estimated_value": 48000,
        "currency": "EUR",
        "lots": null,
        "main_cpv": "50330000",
        "cpv_codes": ["50330000"],
        "execution_place": "Cantabria",
        "published_date": "2026-10-16",
        "deadline": "2026-10-26T13:00:00+01:00",
        "days_left": 9,
        "submission_platform": "Plataforma de Contratación del Estado",
        "url": "https://contrataciondelestado.es/wps/poc?uri=deeplink:detalle_licitacion&idEvl=AtvacxRpmXcmMOlAXxDEjw%3D%3D",
        "last_updated": "2026-10-16T12:29:02+02:00"
      }
    ],
    "pagination": { "total": 7, "page": 1, "limit": 20, "total_pages": 1, "has_more": false }
  },
  "meta": {
    "source": "Plataforma de Contratación del Sector Público (incluye plataformas autonómicas agregadas)",
    "data_updated_at": "2026-10-17T08:56:50+00:00",
    "status_filter": "open"
  }
}
  • status: open (accepting bids), prior_notice (no bids yet) or, with status=all, deadline_passed (deadline expired and the Platform has not updated its status yet), under_evaluation, awarded, cancelled...
  • deadline is in mainland Spain time with its offset; days_left are calendar days until the deadline date (0 = closes today).
  • submission_platform says where to submit the bid: the State Platform or the relevant regional platform.
  • Amounts in euros excluding and including VAT; estimated_value includes planned extensions and modifications.

Tenders for a company

With cif, the API looks at the titles of the public contracts that company has won in the last 5 years, extracts the words that define what it does and returns the most similar open tenders, ranked by similarity (match_score). It can be combined with the other filters (e.g. province). If the company has no awarded contracts, company.note says so and there are no results.

curl "https://spaincompanyapi.com/api/v1/tenders?cif=A82018474" -H "X-API-KEY: your_api_key"
{
  "success": true,
  "data": {
    "company": {
      "cif": "A82018474",
      "name": "TELEFONICA DE ESPAÑA SAU",
      "contracts_used": 60,
      "keywords": ["telecomunicaciones", "datos", "internet", "telefonía", "comunicaciones", "fija", "infraestructuras", "móvil"]
    },
    "tenders": [
      {
        "title": "Servicios e infraestructura telefonia fija, datos y enlaces especiales de la i3d",
        "match_score": 19.31,
        "...": "same fields as above"
      }
    ],
    "pagination": { "total": 6, "page": 1, "limit": 20, "total_pages": 1, "has_more": false }
  }
}

Restricted response (403 Forbidden - Free and Pro plans)

{
  "success": false,
  "error": "PLAN_RESTRICTION",
  "message": "Las licitaciones públicas abiertas requieren el plan Business.",
  "required_plan": "business",
  "upsell_opportunities": {
    "mensaje": "Hay 45 licitaciones que cumplen tu búsqueda. Con el plan Business las ves todas, con importe, plazo, CPV y enlace para presentarte.",
    "upgrade_url": "https://apiempresas.es/billing?plan=business&source=api_403_tenders",
    "licitaciones_encontradas": 45,
    "muestra": [
      {
        "title": "Servicio de limpieza para centros y establecimientos del Área de Atención...",
        "contracting_authority": "...",
        "province": "Ceuta",
        "amount_excl_vat": 11963978.09,
        "deadline": "2026-10-20T23:59:00+02:00"
      }
    ]
  }
}

The 403 does not use queries. The tender count and sample are included in up to 25 403 responses per day per account. Cost on Business: 1 query per call.

9.2 Public Grants and Subsidies (Business Plan Only)

Grants, loans, guarantees and tax benefits awarded to a company according to Spain's National Grants Database (BDNS), since 2022, including the Kit Digital and Kit Consulting programmes. Returns a summary (total, by year, by instrument and the 10 calls with the largest amount) and the list of grants, newest first, paginated.

Useful to know whether a customer or supplier depends on public funding, for due diligence and for prospecting (companies that have just received funds to digitalise or invest). Companies only: grants to individuals are not published here.

GET /companies/subsidies Business
ParameterTypeRequiredDescription
cifstringRequiredCIF of the company (e.g. A38666897).
yearintegerOptionalOnly grants awarded in that year (e.g. 2025). The summary is computed for that year too.
pageintegerOptionalPage number. Default: 1.
limitintegerOptionalGrants per page. Default: 20 (max: 100).

Success response (200 OK - Business plan)

{
  "success": true,
  "data": {
    "cif": "A38666897",
    "company_name": "BINTER CANARIAS SA",
    "year": null,
    "summary": {
      "total_grants": 133,
      "total_amount": "181847.85",
      "currency": "EUR",
      "first_grant_date": "2024-12-26",
      "last_grant_date": "2025-01-08",
      "by_year": [
        { "year": 2025, "grants": 129, "amount": "179842.14" },
        { "year": 2024, "grants": 4, "amount": "2005.71" }
      ],
      "by_instrument": [
        { "instrument": "SUBVENCIÓN y ENTREGA DINERARIA SIN CONTRAPRESTACIÓN", "grants": 133, "amount": "181847.85" }
      ],
      "top_calls": [
        {
          "call": "Subvenciones al transporte aéreo para residentes en Canarias, Baleares, Ceuta y Melilla",
          "grants": 133,
          "amount": "181847.85",
          "last_grant_date": "2025-01-08"
        }
      ]
    },
    "grants": [
      {
        "grant_date": "2025-01-08",
        "amount": "228.75",
        "currency": "EUR",
        "call": "Subvenciones al transporte aéreo para residentes en Canarias, Baleares, Ceuta y Melilla",
        "instrument": "SUBVENCIÓN y ENTREGA DINERARIA SIN CONTRAPRESTACIÓN",
        "grant_code": "SB123457636"
      }
    ],
    "pagination": {
      "total": 133,
      "page": 1,
      "limit": 20,
      "total_pages": 7,
      "has_more": true
    },
    "sources": {
      "subsidies": { "source": "bdns", "as_of": "2026-10-18", "from": "2022-01-01" }
    }
  }
}

Restricted response (403 Forbidden - Free and Pro plans)

{
  "success": false,
  "error": "PLAN_RESTRICTION",
  "message": "Las subvenciones y ayudas públicas requieren el plan Business.",
  "upsell_opportunities": {
    "mensaje": "Esta empresa tiene 133 subvenciones o ayudas públicas por 181.848 €. Con el plan Business ves cada una: convocatoria, fecha, importe e instrumento.",
    "upgrade_url": "https://apiempresas.es/billing?plan=business&source=api_403_subsidies",
    "subvenciones_detectadas": 133,
    "importe_total": 181847.85,
    "currency": "EUR",
    "ultima_concesion": "2025-01-08"
  }
}

Amounts are strings with two decimals, as in Public Contracts. Call and instrument names are returned in Spanish, as published by the BDNS. sources.subsidies.as_of is the date of the last load from the BDNS. 403 responses do not use quota, and the upsell_opportunities summary is included in up to 25 403 responses per account per day. Cost on Business: 1 request per call.

🚀 Ready to get started?

Get your API Key in seconds and start integrating real data into your applications.

Go to Control Panel
🤖
Asistente IA En línea
¡Hola! Soy el asistente de APIEmpresas. ¿En qué puedo ayudarte hoy?