---
title: "Get paginated company events"
method: GET
path: "/api/v1/company/{slug}/events"
tags: ["Companies", "BORME"]
---

# Get paginated company events

`GET /api/v1/company/{slug}/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.

## Path parameters

- `slug` string, required

## Query parameters

- `year` integer
- `page` integer
- `page_size` integer

## Headers

- `If-None-Match` string

## Response `200`

Paginated event list

- CompanyEventsResponse
  - `slug` string, required
  - `year` string, required
  - `page` integer, required
  - `page_size` integer, required
  - `total` integer, required
  - `pages` integer, required
  - `items` BormeEvent[], required
    - `id` string, nullable
    - `date` string, nullable
    - `publish_date` string, nullable
    - `type` string, nullable
    - `act_type` string, nullable
    - `title` string, nullable
    - `text` string, nullable
    - `province` string, nullable
    - `source` string, nullable
    - `source_url` string, uri, nullable

## Other responses

- `304` — The generation-bound event page has not changed.
- `400` — Invalid request
- `404` — Resource not found
- `422` — A validly typed year, page or page_size is outside its documented range
- `429` — Rate limit exceeded
- `500` — The bounded operation failed without exposing internal exception details.
- `503` — The public read failed closed because its legal source catalog, subject classification, bounded projection, database helper or required artifact is unavailable. Clients must not infer an empty result.

---

[API](https://skmtc.net/openmercantil/apis/openmercantil-public-api.md) · [All operations](https://skmtc.net/openmercantil/apis/openmercantil-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openmercantil/openmercantil-public-api/revisions/996f96a11758/schema)