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

# List businesses

`GET /v1/businesses`

## Request

- Base URL: `https://api.slant.app`
- URL: `https://api.slant.app/v1/businesses`
- Auth: HTTP bearer

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
    - `custom_fields` object: Business custom field values keyed by field_key
    - `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' | 'inactive', required
      - `is_primary` boolean, required
      - `id` string: The email address ID
    - `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
      - `id` string: The phone number ID
    - `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
      - `id` string: The address ID
    - `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 - malformed JSON, invalid filters, or missing required book context
- `401`: unauthorized - missing or invalid token
- `403`: Access denied. Policy and membership failures may have an empty body. A read-only personal token cannot perform writes.
- `429`: An hourly API rate limit was exceeded. Wait Retry-After seconds before retrying.

## Changes

- **2026-11-03** `173c41bf6be9`: 1 warning, 8 info
  - added the new `inactive` enum value to the `data/items/email_addresses/items/email_type` response property for the response status `200`
  - added the media type `application/json` for the response with the status `403`
  - added the non-success response with the status `429`
  - added the optional property `data/items/addresses/items/id` to the response with the `200` status
  - …5 more

[Operation history](https://skmtc.dev/slant/apis/slant-public-api-v1/changes/v1/businesses/get.md)

---

[API](https://skmtc.dev/slant/apis/slant-public-api-v1.md) - [All operations](https://skmtc.dev/slant/apis/slant-public-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/slant/apis/slant-public-api-v1/revisions/173c41bf6be9?raw)