Skip to main content
POST
/
businesses
/
me
/
switch
Switch current business account context
curl --request POST \
  --url https://api.leadping.ai/businesses/me/switch \
  --header 'Content-Type: application/json' \
  --data '
{
  "businessId": "<string>"
}
'
{
  "secondaryName": "<string>",
  "user": {
    "id": "<string>",
    "name": "<string>"
  },
  "accountBalance": "<string>",
  "autoRefillEnabled": true,
  "autoRefillAmount": "<string>",
  "autoRefillTrigger": "<string>",
  "enabled": true,
  "adminEnablementOverride": {
    "enabled": true,
    "reason": "<string>",
    "updatedByUserId": "<string>",
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "phone": "<string>",
  "website": "<string>",
  "address": {
    "line1": "<string>",
    "line2": "<string>",
    "city": "<string>",
    "state": "<string>",
    "province": "<string>",
    "region": "<string>",
    "postalCode": "<string>",
    "country": "<string>",
    "additionalInfo": "<string>"
  },
  "vertical": "<string>",
  "description": "<string>",
  "ein": "<string>",
  "einDocument": {
    "id": "<string>",
    "name": "<string>",
    "value": "<string>"
  },
  "domain": "<string>",
  "phones": [
    {
      "id": "<string>",
      "name": "<string>",
      "value": "<string>"
    }
  ],
  "site": {
    "id": "<string>",
    "name": "<string>"
  },
  "activation": {
    "controlledLaunch": true,
    "customerFacingStatus": "<string>",
    "paymentMethodConfirmedAt": "2023-11-07T05:31:56Z",
    "subscriptionPendingAt": "2023-11-07T05:31:56Z",
    "subscriptionActiveAt": "2023-11-07T05:31:56Z",
    "launchReviewRequestedAt": "2023-11-07T05:31:56Z",
    "launchApprovedAt": "2023-11-07T05:31:56Z",
    "telephonyProvisioningStartedAt": "2023-11-07T05:31:56Z",
    "telephonyPartiallyProvisionedAt": "2023-11-07T05:31:56Z",
    "telephonyReadyAt": "2023-11-07T05:31:56Z",
    "failedAt": "2023-11-07T05:31:56Z",
    "activatedAt": "2023-11-07T05:31:56Z",
    "industry": "<string>",
    "businessDescription": "<string>",
    "targetAudience": "<string>",
    "offer": "<string>",
    "websiteNeeds": "<string>",
    "serviceArea": "<string>",
    "complianceNotes": "<string>",
    "domainOptions": [
      {
        "domainName": "<string>",
        "whyItFits": "<string>",
        "industryRelevance": "<string>",
        "trustConcerns": "<string>",
        "estimatedAnnualCost": "<string>",
        "availabilityStatus": "<string>",
        "recommended": true
      }
    ],
    "selectedDomain": "<string>",
    "domainApprovedAt": "2023-11-07T05:31:56Z",
    "websiteUrl": "<string>",
    "tenDlcDraft": {
      "companyName": "<string>",
      "contactName": "<string>",
      "contactEmail": "<string>",
      "contactPhone": "<string>",
      "ein": "<string>",
      "websiteUrl": "<string>",
      "industry": "<string>",
      "useCase": "<string>",
      "useCaseDescription": "<string>",
      "messageExamples": [
        "<string>"
      ],
      "optInLanguage": "<string>",
      "privacyPolicyUrl": "<string>",
      "termsUrl": "<string>",
      "expectedMonthlyVolume": "<string>",
      "leadSource": "<string>",
      "trustedFormRequired": true,
      "complianceWarnings": [
        "<string>"
      ],
      "missingFields": [
        "<string>"
      ],
      "lastSubmittedAt": "2023-11-07T05:31:56Z",
      "rejectionReason": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z",
      "version": "<string>"
    },
    "events": [
      {
        "id": "<string>",
        "type": "<string>",
        "title": "<string>",
        "details": "<string>",
        "status": "<string>",
        "actorName": "<string>",
        "failureReason": "<string>",
        "createdAt": "2023-11-07T05:31:56Z"
      }
    ],
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  },
  "compliancePolicy": {
    "enabled": true,
    "allowedStates": [
      "<string>"
    ],
    "allowedProducts": [
      "<string>"
    ],
    "requireLeadState": true,
    "requireAgentLicenseState": true,
    "requireProduct": true,
    "requireTrustedFormForAutomations": true,
    "requireSourceComplianceApproval": true
  },
  "name": "<string>",
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "modifiedAt": "2023-11-07T05:31:56Z"
}

Body

The selected business identifier.

Request payload for business switch.

​
businessId
string

The business ID associated with this business switch.

Response

Returns the business response.

API response containing business data returned to callers.

​
secondaryName
string | null

The secondary name value for this business.

​
user
object

The user value for this business.

​
accountBalance
string<double>

The wallet balance owned by this business.

Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
​
autoRefillEnabled
boolean

Whether auto refill is enabled for this business wallet.

​
autoRefillAmount
string<double> | null

The monetary auto refill amount for this business wallet.

Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
​
autoRefillTrigger
string<double> | null

The auto refill trigger value for this business wallet.

Pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
​
status
enum<string> | null

Defines the supported Business Status values.

Available options:
SettingUp,
SetupCompleted,
Active
​
enabled
boolean
​
adminEnablementOverride
object
​
phone
string | null

The phone number associated with this business.

​
website
string | null

The website URL associated with this business.

​
address
object

The postal address associated with this business.

​
vertical
string | null

The vertical value for this business.

​
description
string | null

The human-readable description of this business.

​
ein
string | null

The EIN value for this business.

​
einDocument
object

The EIN document value for this business.

​
domain
string | null

The domain name associated with this business.

​
phones
object[] | null

The phones included with this business.

​
site
object

The site value for this business.

​
setupStep
enum<string> | null

Defines the supported Business Setup Step values.

Available options:
DomainFinding,
DomainOptionsFound,
SiteGenerating,
SiteGenerated,
BrandSubmitted,
BrandApproved,
CampaignSubmitted,
CampaignApproved,
CarrierReviewing,
TenDlcComplete,
Complete
​
activation
object

The activation value for this business.

​
compliancePolicy
object

The compliance policy value for this business.

​
name
string

The display name for the entity.

​
id
string

The unique identifier for the entity.

​
createdAt
string<date-time>

The date and time when the entity was created.

​
modifiedAt
string<date-time> | null

The date and time when the entity was last modified, if applicable.