---
title: "Dry-run: validate business-profile fields and report field-level errors without"
method: POST
path: "/v2/business-profiles/validate"
tags: ["business-profiles-v2"]
---

# Dry-run: validate business-profile fields and report field-level errors without

`POST /v2/business-profiles/validate`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/business-profiles/validate`
- Auth: API key in header `X-Api-Key`

saving. `readyForVerification` is true when the profile is valid and carries every
field KYB submission needs.

## Request body

- BusinessProfileWrite
  - `addressCity` string: City
  - `addressCountry` string: ISO 3166-1 country (alpha-2, alpha-3, or name)
  - `addressPostalCode` string: Postal code
  - `addressState` string: State/region (coerced to a 2-letter code where applicable)
  - `addressStreet` string: Street
  - `brandName` string: Brand name
  - `businessContactFirstName` string: Authorized contact first name
  - `businessContactLastName` string: Authorized contact last name
  - `businessRelationship` 'account_business' | 'client_business'
  - `companyLegalName` string: Registered legal entity name (as on IRS/registry records)
  - `confirmed` boolean: Explicit confirmation when establishing an existing business relationship.
  - `contactEmail` string: Business contact email
  - `expectedIdentityRevision` integer: Required for canonical-name confirmation and existing-business confirmation.
  - `identifierType` string: Type of value in taxId (e.g. ein, cbn, neq, provincial_number, registration_number). Auto-defaulted for countries with exactly one legal value; CA requires an explicit choice.
  - `industry` string: Industry / vertical
  - `name` string, required: Profile label (required on create). Max 100 chars.
  - `taxId` string: EIN/TIN — validated against the address country
  - `websiteUrl` string: Business website URL

## Response `200`

Success

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)