A company's public contract awards
company_contractsList a company's public contract awards, ordered by publication date, newest first: the REST API's GET /v1/companies/{slug}/contracts.
Use it for one company's awards; a name is searched as in company_history: several matches return {ambiguous: true, candidates}, none returns {error, suggested_companies}.
Returns JSON {company_slug, nif, count, offset, next_offset, contracts: [{source, award_id, published, awarded_on, buyer, title, lot, amount_eur, cpv, notice_url, minor}], sources}. Awards come from Spanish and EU public procurement notices, matched by tax ID; awards published in multiple notices are listed once. nif null means we hold no tax ID for the company, not that it won nothing; count 0 is not proof it never won a contract. Legal-entity winners only; TED notices in the pre-eForms format (January-June 2024) are not included.
Read-only; one request per call. Requires the Basic plan or higher and an 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_contracts"
}
}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. | |
| source | No | Optional, one or more of placsp, navarra, ted separated by commas, e.g. ted; omit for all. | |
| company | Yes | Company slug as returned by search_companies or company_history (e.g. vaz-metales-sl), or a name to search. | |
| date_to | No | Optional latest publication date, YYYY-MM-DD, e.g. 2024-12-31. | |
| date_from | No | Optional earliest publication date, YYYY-MM-DD, e.g. 2024-01-01. | |
| min_amount | No | Optional minimum award amount in EUR, e.g. 100000. |