A company's public aid (BDNS)
company_grantsList the public aid awards that BDNS, Spain's national database of subsidies and other public aid, records for a company's tax ID, newest first.
Use it for a known company (a slug from search_companies).
Returns JSON {company_slug, nif, link, shown_from, data_as_of, attribution, totals {by_instrument, by_year}, count, next_offset, truncated, items [{concession_id, granted_on, instrument, amount_eur, aid_equivalent_eur, call {title, level, administration, body}}], note}. Only instrument subsidy is a grant: a loan's amount_eur is the principal lent and a guarantee's the amount guaranteed, so never call them grants. Totals are per instrument; do not add nominal amounts across instruments. Awards before shown_from are no longer shown by BDNS. Quote attribution and data_as_of with the data. An empty list means none is linked in our data, not that none was received.
Read-only. Needs the basic plan or higher: send your API key in the X-API-Key header (https://bormeapi.com/account).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"company": "<company>"
},
"name": "company_grants"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Awards per page, integer 1-200, e.g. 20 (default 50). | |
| offset | No | Awards to skip, integer 0-10000 (default 0); pass the previous page's next_offset, e.g. 50. | |
| company | Yes | Company slug, as returned by search_companies or company_history, e.g. vaz-metales-sl. | |
| date_to | No | Optional latest award date, YYYY-MM-DD, e.g. 2025-12-31. | |
| date_from | No | Optional earliest award date, YYYY-MM-DD, e.g. 2024-01-01. | |
| instrument | No | Optional list of aid instruments, each one of subsidy, loan, guarantee, tax_advantage, risk_finance, other, e.g. ["subsidy"]; omit for all. |