{
"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"
}
Business Verification (v2)
List Business Profiles
Retrieve your account’s business/brand profiles and their verification status.
GET
/
v2
/
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. Each number request must explicitly confirm the matching business and its current identity revision. A verified status elsewhere on the account does not authorize another entity’s request.
This endpoint is read-only. Use these records within the number-request verification flow. 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
Show Business profile object properties
string
Business identifier used in explicit number-request binding.
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. Provisioning requires current accepted evidence and an explicit matching request binding.integer
Current identity revision; legacy profiles may report 0. Send this revision with explicit confirmation.
string
account_business, client_business, or null when not yet confirmed.string
Suggested legal name while
name_confirm_required; otherwise null.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. |
Next Steps
Get Business Profile
Fetch a single profile by id
Create Number Request
Confirm the selected business on a number request