---
title: "List Record Books"
method: GET
path: "/record-books"
tags: ["Record Books"]
---

# List Record Books

`GET /record-books`

Returns a paginated list of record books for companies the authenticated user has access to. Optionally filter by company.

## Query parameters

- `limit` integer
- `page` integer
- `company_id` string, uuid
- `include` string[]

## Response `200`

Success

- object
  - `has_more` boolean — Indicates if there are more results available beyond the current page.
  - `data` RecordBook[]
    - `id` string, uuid, required — UUID of the record book
    - `company` Company
      - `id` string, required — id of the company
      - `legal_name` string, required — The company’s exact legal name, including punctuation. We use this data for harvesting data from state agencies, so accuracy ensures the right match.
      - `formation_date` string, date, nullable — Company formation date (YYYY-MM-DD)
      - `fiscal_year_end` string, nullable — Fiscal year end in MM/DD format, or null
      - `phone` string, nullable — Company phone number
      - `toll_free_phone` string, nullable — Company toll-free phone number
      - `email` string, nullable — Company email address
      - `fax` string, nullable — Company fax number
      - `no_fax` boolean — Whether the company has no fax number
      - `website` string, nullable — Company website URL
      - `no_website` boolean — Whether the company has no website
      - `mission` string, nullable — Company mission statement
      - `purpose_statement` string, nullable — Company purpose statement
      - `primary_product_or_service` string, nullable — Primary product or service of the company
      - `ein` string, nullable — Employer Identification Number
      - `domicile` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
        - `id` string, uuid, required — ID of the jurisdiction
        - `name` string, required — Name of the jurisdiction
      - `business_structure` BusinessStructure
        - `id` string, required — id of the business structure
        - `name` string, required — Name of the business structure
      - `principal_address` Address
        - `address_line_1` string, required — First line of the address
        - `address_line_2` string, nullable — Second line of the address (optional)
        - `locality` string, required — City or locality
        - `postal_code` string, required — Postal code
        - `administrative_area` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
          - `id` string, uuid, required — ID of the jurisdiction
          - `name` string, required — Name of the jurisdiction
        - `country` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
          - `id` string, uuid, required — ID of the jurisdiction
          - `name` string, required — Name of the jurisdiction
      - `mailing_address` Address
        - `address_line_1` string, required — First line of the address
        - `address_line_2` string, nullable — Second line of the address (optional)
        - `locality` string, required — City or locality
        - `postal_code` string, required — Postal code
        - `administrative_area` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
          - `id` string, uuid, required — ID of the jurisdiction
          - `name` string, required — Name of the jurisdiction
        - `country` Jurisdiction — A geographic jurisdiction (country, state/province, locality, etc.) returned in API responses. Always includes both id and name.
          - `id` string, uuid, required — ID of the jurisdiction
          - `name` string, required — Name of the jurisdiction
      - `tax_classification` IrsTaxClassification
        - `id` string, required — UUID of the IRS tax classification
        - `name` string, required — Name of the tax classification
      - `accounting_method` AccountingMethod
        - `id` string, required — UUID of the accounting method
        - `name` string, required — Name of the accounting method
      - `signers` User[] — Preferred signers for this company
        - `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
    - `rm_ref_entity_type` RmRefEntityType — The record book entity type (e.g. LLC, Profit Corp, Nonprofit Corp).
      - `name` string, required — Name of the entity type

## Other responses

- `401` — Unauthenticated
- `403` — Forbidden - User does not have access

---

[API](https://skmtc.net/harborcompliance/apis/harbor-compliance-api.md) · [All operations](https://skmtc.net/harborcompliance/apis/harbor-compliance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/harborcompliance/harbor-compliance-api/revisions/f9302ec2ef8a/schema)