---
title: "List Record Book Officers"
method: GET
path: "/record-books/{id}/officers"
tags: ["Record Book Officers"]
---

# List Record Book Officers

`GET /record-books/{id}/officers`

## Request

- Base URL: `https://www.harborcompliance.com/api/v1`
- URL: `https://www.harborcompliance.com/api/v1/record-books/{id}/officers`
- Auth: OAuth 2
  - Authorization code: `/api/v1/oauth/authorize`
  - Token URL: `/api/v1/oauth/access_token`
- TypeScript: <https://skmtc.dev/harborcompliance/apis/harbor-compliance-api/docs/record-books/:id/officers/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a paginated list of officers for the specified record book.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `limit` integer
- `page` integer

## Response `200`

Success

- object
  - `has_more` boolean: Indicates if there are more results available beyond the current page.
  - `data` RecordBookOfficer[]
    - `id` string, uuid, required: UUID of the officer record
    - `user` User
      - `id` string, uuid: UUID of the user
      - `first_name` string: First name of the user
      - `middle_name` string, nullable: Middle name of the user
      - `last_name` string: Last name of the user
      - `full_name` string: Full name of the user
      - `email` string: Email of the user
    - `title` object: The officer's title (e.g. President, Secretary)
      - `id` string, uuid
      - `name` string
    - `start_date` string, date, nullable: Officer start date (YYYY-MM-DD)
    - `end_date` string, date, nullable: Officer end date (YYYY-MM-DD)

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden - User does not have access or record book not found

---

[API](https://skmtc.dev/harborcompliance/apis/harbor-compliance-api.md) - [All operations](https://skmtc.dev/harborcompliance/apis/harbor-compliance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/harborcompliance/apis/harbor-compliance-api/revisions/f9302ec2ef8a?raw)