sirenic

Public procurement and EU funding

Public procurement of a Spanish company

Every day the Spanish Ministry of Finance publishes, in CODICE and under written reuse conditions, the tenders of the profiles hosted by the public-procurement platform and those of the aggregated regional platforms (close to half a million award results a year), as well as the minor contracts of the hosted profiles. This route finds a company by its NIF, as a winner (lot, result, amounts, buyer) and as a buyer when the public entity carries a NIF; minor contracts, very numerous and of low value, are served in their own lists.

https://api.sirenic.eu/v1OpenAPI 3.1llms.txt

GET/v1/eu/entreprise/ES/{nif}/marches-publics

Price
$0.02
Free quota
Included
Family
Public procurement and EU funding
Parameters
ParameterWhereExample
nifpath · requiredA26019992

What is charged

  • 200Ed25519-signed response, charged at the route's price
  • 402Signed x402 quote, nothing is debited
  • 4xxUnknown or invalid identifier, never charged
  • 5xxUpstream source unavailable, or a counted total below the list read (compte_incoherent), never charged

See a real response (free) Get the quote for /v1/eu/entreprise/ES/{nif}/marches-publics

What the route returns

Catalogue description, exactly as agents read it:

Public procurement of a Spanish company from the Plataforma de Contratación del Sector Público (Ministry of Finance CODICE feeds: hosted profiles and regional platforms since 2012, minor contracts since 2018): contracts WON by legal-person NIF (buyer name and DIR3, subject, CPV, lot, result, award date, EUR amounts, bids, SME flag) and notices ISSUED as a buyer; minor contracts in their own lists; newest 100 per list. Never a natural-person winner. Reuse under the ministry's conditions.

Expected identifier

Legal-person NIF: one letter, seven digits, a check character (e.g. A28582013).

A wrongly formatted identifier in the path returns 400 and is not billed, but it costs you a round trip. It is the leading cause of failed calls on the foreign routes. A search parameter, by contrast, is cleaned up: unsupported characters are stripped and the usable query is served.

Price and billing

Price: $0.02. The authoritative amount is the one in the 402 quote returned by the route itself, not this text, which derives from the same grid but is still just a page.

An error response cancels the payment: a 400, 404 or 503 is never billed. An upstream outage closes the route with a 503 rather than serving a degraded response.

What this route does not do

Partial coverage by construction: 20 % of tender results carried no winner NIF (consortia without their own NIF, void lots; measured on August 2025) and Spain has no open register by NIF: a NIF with no row answers 404 without charge, never a sold zero. Never a natural-person winner (DNI, NIE, masked identifier), never a contact; a minor contract won by a natural person is not served. Amounts in EUR as published. Source: Ministerio de Hacienda.

Neighbouring routes

  • /v1/eu/entreprise/ES/{hoja}/actes: $0.02
  • /v1/eu/entreprise/LV/{regnr}/marches-publics: $0.02
  • /v1/eu/entreprise/GB/{company_number}/marches-publics: $0.02

How you pay

Every route is paid per call, two ways, with no subscription: over x402, in USDC or EURC on the Base network, with no account and no API key; or with the API key of an account, which opens the free quota. Over x402, the first call returns a 402 quote your client settles, then replays the call. A failed call is never billed.

Open today: 150 free calls a month with an account, up to EUR 2 of value, on 122 of 129 routes (the price list says which), with 100 more free lines a month on batch identity, and pay-per-call over x402 (USDC or EURC), with no account except registry filings. Prepaid credits: card top-up is not open yet.

Paid responses are Ed25519-signed: you can later prove what was served to you, and when. The whole catalogue is free to read in the OpenAPI document and in llms.txt.

One call, end to end

# x402 client (npm): the 402 quote is settled and the call replayed automatically
npx x402-fetch https://api.sirenic.eu/v1/entreprise/552032534

# Or over MCP, in Claude Code / Cursor
claude mcp add --transport http sirenic https://api.sirenic.eu/mcp

# Or as a local server (stdio), with your key or an x402 wallet
claude mcp add sirenic -e SIRENIC_API_KEY=srn_live_... -- npx -y sirenic-mcp

Routes used and pricing

RoutePriceSampleWhat it returns
/v1/eu/entreprise/ES/{nif}/marches-publics$0.02free samplePublic procurement of a Spanish company from the Plataforma de Contratación del Sector Público (Ministry of Finance CODICE feeds: hosted profiles and regional platforms since 2012, minor contracts since 2018): contracts WON by legal-person NIF (buyer name and DIR3, subject, CPV, lot, result, award date, EUR amounts, bids, SME flag) and notices ISSUED as a buyer; minor contracts in their own lists; newest 100 per list. Never a natural-person winner. Reuse under the ministry's conditions.

Contract end dates are estimates, computed from the notification date and the declared duration. This is not an official re-tendering calendar.

Take it further

The first step is free and shows you exactly what you would be buying, with no account or key; an account, with its API key, then opens the free quota.

See a real response (free) Get the quote for /v1/eu/entreprise/ES/{nif}/marches-publics Create an account: 150 free calls a month up to EUR 2 of value

Read next

OpenAPI · llms.txt · Full route catalogue and pricing