List Business Profiles

{
  "businessProfiles": [
    {
      "id": "664a1b2c3d4e5f6071829300",
      "name": "Acme Retail Profile",
      "brandName": "Acme Co",
      "companyLegalName": "Acme Incorporated",
      "verificationStatus": "verified",
      "taxIdLast4": "6789",
      "websiteUrl": "https://acme.com",
      "contactEmail": "support@acme.com",
      "addressCountry": "US",
      "createdAt": "2026-05-01T12:00:00Z"
    }
  ],
  "pagination": { "page": 1, "per_page": 50, "total": 1, "total_pages": 1 }
}

{
  "error": "Invalid credentials",
  "code": "invalid_credentials"
}

GET

business-profiles

{
  "businessProfiles": [
    {
      "id": "664a1b2c3d4e5f6071829300",
      "name": "Acme Retail Profile",
      "brandName": "Acme Co",
      "companyLegalName": "Acme Incorporated",
      "verificationStatus": "verified",
      "taxIdLast4": "6789",
      "websiteUrl": "https://acme.com",
      "contactEmail": "support@acme.com",
      "addressCountry": "US",
      "createdAt": "2026-05-01T12:00:00Z"
    }
  ],
  "pagination": { "page": 1, "per_page": 50, "total": 1, "total_pages": 1 }
}

{
  "error": "Invalid credentials",
  "code": "invalid_credentials"
}

Returns all non-archived business profiles on your account, newest first. A Business Profile owns business-verification identity and status. Any active verified-equivalent profile satisfies the account eligibility gate for Create Number Request; the Number Request separately accepts request-owned identity inline and rejects businessProfileId.

This endpoint is read-only. Create and verify Business Profiles through the Business Profile flow before submitting a number request. Number Request submission does not auto-create a profile.

Query Parameters

integer

default:"1"

Page number.

integer

default:"50"

Items per page (max 100).

Response Fields

object

page, per_page, total, and total_pages.

array

Array of business profile objects.

Show Business profile object properties

string

Unique identifier for Business Profile operations. It is not accepted by Number Request endpoints.

string

User-assigned profile label.

string

Brand name.

string

Registered legal entity name.

string

KYB verification state. Common values: unverified, pending, verified, admin_review, rejected, locked, admin_override, legacy_grandfathered. The account needs an active verified-equivalent profile before it can submit or provision a Number Request.

string

Last 4 digits of the EIN/TIN, to disambiguate profiles. The full tax id is never returned by the API.

string

Business website.

string

Brand contact email.

string

Authorized brand contact first name.

string

Authorized brand contact last name.

string

Street address. (Also addressCity, addressState, addressPostalCode, addressCountry.)

datetime

ISO 8601 timestamp of creation.

Examples

cURL

curl -X GET "https://api.tracklysms.com/api/v2/business-profiles" \
  -H "X-Api-Key: trk_your_api_key_here"

Python

import requests

resp = requests.get(
    "https://api.tracklysms.com/api/v2/business-profiles",
    headers={"X-Api-Key": "trk_your_api_key_here"},
)
for bp in resp.json()["businessProfiles"]:
    print(bp["id"], bp["brandName"], bp["verificationStatus"])

{
  "businessProfiles": [
    {
      "id": "664a1b2c3d4e5f6071829300",
      "name": "Acme Retail Profile",
      "brandName": "Acme Co",
      "companyLegalName": "Acme Incorporated",
      "verificationStatus": "verified",
      "taxIdLast4": "6789",
      "websiteUrl": "https://acme.com",
      "contactEmail": "support@acme.com",
      "addressCountry": "US",
      "createdAt": "2026-05-01T12:00:00Z"
    }
  ],
  "pagination": { "page": 1, "per_page": 50, "total": 1, "total_pages": 1 }
}

{
  "error": "Invalid credentials",
  "code": "invalid_credentials"
}

Error Codes

HTTP Status	Error Code	Description
401	`invalid_credentials`	API key is missing or invalid.
403	`account_suspended`	Your account is suspended. Resolve outstanding billing or contact support.
429	`rate_limited`	Request throttled; retry with exponential backoff after the window resets.

API Reference

V2 API Reference

Partner Accounts (v2)

Messages (v2)

Contacts (v2)

Lists (v2)

Number Requests (v2)

Business Profiles (v2)

Creatives (v2)

Audiences (v2)

Offers (v2)

Schedules (v2)

Revenue (v2)

Usage & Billing (v2)

Data Import (v2)

Links (v2)

Clicks (v2)

Webhooks (v2)

Phone Validation (v1)

API Reference (v1 - Deprecated)

List Business Profiles

Query Parameters

Response Fields

Examples

Error Codes

Next Steps

Get Business Profile

Create Number Request

​Query Parameters

​Response Fields

​Examples

​Error Codes

​Next Steps

Get Business Profile

Create Number Request

Query Parameters

Response Fields

Examples

Error Codes

Next Steps