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
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 requestsresp = 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"])