Upsert business info | Atlas

curl -X PUT https://api.youratlas.com/v1/api/business-verification \
     -H "api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "email": "contact@greenleafgardens.com",
  "address": {
    "customerName": "Greenleaf Gardens LLC",
    "street": "1234 Elm Street",
    "city": "Springfield",
    "region": "IL",
    "postalCode": "62704",
    "isoCountry": "US"
  },
  "businessInformation": {
    "business_type": "Limited Liability Company",
    "business_registration_number": "LLC-2023-56789",
    "business_name": "Greenleaf Gardens LLC",
    "business_registration_identifier": "IL-56789",
    "business_identity": "direct_customer",
    "business_industry": "Landscaping and Gardening",
    "website_url": "https://www.greenleafgardens.com",
    "business_regions_of_operation": "Midwest USA"
  },
  "authorizedRep1": {
    "first_name": "Emily",
    "last_name": "Watson",
    "email": "emily.watson@greenleafgardens.com",
    "phone_number": "+12175551234",
    "business_title": "Chief Operating Officer",
    "job_position": "Operations Manager"
  }
}'

{
  "secondaryProfileSid": "SP1234567890abcdef",
  "addressSid": "AD0987654321fedcba",
  "addressDocumentSid": "DOC1122334455aabbcc",
  "businessInfoEndUserSid": "BU5566778899ddeeff",
  "ar1EndUserSid": "AR1234432112344321",
  "ar2EndUserSid": "",
  "trustProductSid": "TP9988776655ccbbaa",
  "secondaryProfileStatus": "draft",
  "trustProductStatus": "draft",
  "lastEvaluationErrors": null,
  "lastUpdated": "2024-01-15T09:30:00Z"
}

Creates or updates the business verification profile and enqueues a background worker that provisions the Twilio Secondary Customer Profile. Returns 202 with the current profile snapshot.

Authentication

api-keystring

Your Atlas API key. Get it from the Atlas Portal under Settings > API Keys.

Request

This endpoint expects an object.

emailstringRequiredformat: "email"

Notification email for verification status updates

addressobjectRequired

businessInformationobjectRequired

authorizedRep1objectRequired

friendlyNamestringOptional

Optional display name for the business profile

authorizedRep2objectOptional

Response

Accepted — profile saved, background processing started

secondaryProfileSidstring

addressSidstring

addressDocumentSidstring

businessInfoEndUserSidstring

ar1EndUserSidstring

ar2EndUserSidstring

trustProductSidstring

secondaryProfileStatusenum

Allowed values:

trustProductStatusenum

Allowed values:

lastEvaluationErrorsany or null

Parsed evaluation errors from Twilio, or null

lastUpdateddatetime

Errors

400

Bad Request Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error