---
title: "Officers of a company (directors, secretaries, auditors, liquidators)."
method: GET
path: "/v3/companies/{uec}/representatives"
tags: ["Companies"]
---

# Officers of a company (directors, secretaries, auditors, liquidators).

`GET /v3/companies/{uec}/representatives`

## Request

- Base URL: `https://api.datocapital.com`
- URL: `https://api.datocapital.com/v3/companies/{uec}/representatives`
- Auth: HTTP bearer

One item for each role of each officer. The officer (`holder`) is a person (`type: individual`, with a link to the individual profile) or a company (`type: company`, with a link to the company profile). Current roles come first, then former roles, each newest first. Includes the officers recorded under the company's former names.

## Path parameters

- `uec` string, required

## Query parameters

- `status` 'current' | 'former' | 'all'
- `language` 'en' | 'es'
- `page_size` integer
- `cursor` string

## Response `200`

ok

- RepresentativeList
  - `data` Representative[]
    - `holder` object
      - `type` 'individual' | 'company'
      - `name` string
      - `id` string: Individual id, when the person has a profile.
      - `uec` string: Company UEC, when the officer is a company with a profile.
      - `url` string
    - `role` object
      - `name` string: Role in the requested language, else as the register shows it.
      - `name_local` string: Role as the register shows it.
    - `appointed_on` string, date: Absent when the source shows the end of the role only.
    - `ceased_on` string, date: Absent while the role is current.
    - `is_current` boolean
  - `next_cursor` string, nullable
  - `has_more` boolean

## Other responses

- `400`: 400 — bad parameter shape or value.
- `404`: 404 — id is unknown to the public surface.

---

[API](https://skmtc.dev/datocapital/apis/datocapital-api.md) · [All operations](https://skmtc.dev/datocapital/apis/datocapital-api/llms.txt) · [OpenAPI document](https://skmtc.dev/datocapital/apis/datocapital-api/revisions/c0257df2db1a?raw)