v2

latestOpenAPI 3.1.0Source-specific upstream terms; see response catalog metadata2026-07-26139203447.9 KB
Companies
BORME

Get paginated company events

Return BORME events for a known company slug, optionally filtered by calendar year. The closed scalar query contract rejects unknown names, arrays and malformed integer values with 400; valid integers outside their bounds return 422. If year is omitted, the server freezes the current UTC year for the request. Historical coverage starts at 1900 and year must be less than or equal to the current UTC year; there is no fixed calendar ceiling.

get/api/v1/company/{slug}/events

Path parameters

slugstring required
Example:mercadona-sa

Query parameters

yearinteger
Example:2026

Calendar year from 1900 through the current UTC year (year <= current UTC year). Defaults dynamically to the current UTC year.

pageinteger
page_sizeinteger

Headers

If-None-Matchstring

Optional RFC 9110 entity-tag validator. Weak validators, comma-separated validator lists and * are accepted.

Response

Paginated event list

slugstring required
yearstring required
pageinteger required
page_sizeinteger required
totalinteger required
pagesinteger required