---
title: "Get a business"
method: GET
path: "/v1/businesses/{id}"
tags: ["Businesses"]
---

# Get a business

`GET /v1/businesses/{id}`

## Request

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

Retrieve a business by ID

## Path parameters

- `id` string, required

## Response `200`

successful

- Business
  - `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

## 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.
- `404`: not found
- `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 `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 `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/:id/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)