---
title: "Get current and historical company officers"
method: GET
path: "/api/v1/company/{slug}/officers"
tags: ["Companies", "Persons"]
---

# Get current and historical company officers

`GET /api/v1/company/{slug}/officers`

## Request

- Base URL: `https://openmercantil.es`
- URL: `https://openmercantil.es/api/v1/company/{slug}/officers`
- Auth: one of:
  - none
  - API key in header `X-API-Key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/openmercantil/apis/openmercantil-public-api/docs/api/v1/company/:slug/officers/get.ts> (a function with typed inputs; its response is checked against the schema)

Return at most 500 officer mentions from the same cached, policy-filtered company projection used by the canonical company route. The JSON body is capped at 1 MiB. Persons are documentary mentions only — no DNI, contact data or personal address.

## Path parameters

- `slug` string, required

## Response `200`

Officer list

- OfficerDocumentaryMention[]
  - `name` string
  - `person_slug` string, nullable
  - `role` string, nullable
  - `appointed_at` string, nullable
  - `ended_at` string, nullable
  - `source` string, nullable
  - `source_url` string, uri, nullable

## Other responses

- `404`: Resource not found
- `429`: Rate limit exceeded
- `503`: Bounded cached officer projection unavailable

## Changes

- **2026-07-26** `996f96a11758`: 1 breaking, 39 info
  - the response's body type changed from `object` to `array` for status `200`
  - api operation id `getCompanyBySlugOfficers` was added
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `bearerAuth` was added to the API
  - …36 more

[Operation history](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/changes/api/v1/company/:slug/officers/get.md)

---

[API](https://skmtc.dev/openmercantil/apis/openmercantil-public-api.md) - [All operations](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openmercantil/apis/openmercantil-public-api/revisions/601ff6123c86?raw)