---
title: "List businesses"
method: GET
path: "/v1/businesses"
tags: ["Businesses"]
---

# List businesses

`GET /v1/businesses`

List all businesses. Supports filtering by book_id, name, and updated_since.

## Query parameters

- `page` integer
- `per_page` integer
- `book_id` string
- `name` string
- `updated_since` string

## Response `200`

successful

- object
  - `data` Business[], required
    - `id` string, required — The business ID
    - `book_id` string, required — The book ID
    - `name` string, required — Business name
    - `industry` string, nullable — Industry
    - `website_url` string, nullable — Website URL
    - `tax_id` string, nullable — Tax ID
    - `additional_info` string, nullable — Additional information
    - `created_at` string, date-time, required — When the business was created
    - `updated_at` string, date-time, required — When the business was last updated
    - `email_addresses` Email[] — Array of email addresses
      - `email` string, email, required
      - `email_type` 'personal' | 'business' | 'school' | 'other', required
      - `is_primary` boolean, required
    - `phone_numbers` PhoneNumber[] — Array of phone numbers
      - `phone_number` string, required
      - `extension` string, nullable
      - `phone_type` 'mobile' | 'work' | 'home' | 'fax' | 'other', required
      - `is_primary` boolean, required
    - `addresses` Address[] — Array of addresses
      - `line1` string, nullable
      - `line2` string, nullable
      - `city` string, nullable
      - `state` string, nullable
      - `zip` string, nullable
      - `country_code` string, nullable
      - `address_type` 'home' | 'work' | 'mailing' | 'other', required
      - `is_primary` boolean, required
    - `tags` object[] — Array of tags
      - `id` string
      - `name` string
  - `pagination` object, required
    - `current_page` integer
    - `total_pages` integer
    - `total_count` integer
    - `per_page` integer

## Other responses

- `400` — bad request - invalid JSON
- `401` — unauthorized - missing or invalid token
- `403` — forbidden

---

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