Skip to main content
GET
/
v1
/
businesses
List businesses
curl --request GET \
  --url https://api.slant.app/v1/businesses \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "abc123xyz",
      "book_id": "book123xyz",
      "name": "Acme Corp",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "industry": "Technology",
      "website_url": "https://acme.com",
      "tax_id": "12-3456789",
      "additional_info": "<string>",
      "email_addresses": [
        {
          "email": "john.doe@example.com",
          "email_type": "personal",
          "is_primary": true
        }
      ],
      "phone_numbers": [
        {
          "phone_number": "+15555551234",
          "phone_type": "mobile",
          "is_primary": true
        }
      ],
      "addresses": [
        {
          "address_type": "home",
          "is_primary": true,
          "line1": "123 Main St",
          "line2": "Apt 4B",
          "city": "New York",
          "state": "NY",
          "zip": "10001",
          "country_code": "US"
        }
      ],
      "tags": [
        {
          "id": "<string>",
          "name": "<string>"
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 10,
    "total_count": 100,
    "per_page": 25
  }
}

Authorizations

Authorization
string
header
required

OAuth 2.0 Bearer Token from Clerk authentication

Query Parameters

page
integer

Page number

per_page
integer

Items per page (1-100, default: 25). Values over 100 will be clamped to 100.

Required range: 1 <= x <= 100
book_id
string

Filter by book ID

name
string

Filter by business name (prefix match)

updated_since
string

Filter by last updated datetime (ISO8601)

Response

successful

data
object[]
required
pagination
object
required