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-LLC-56789",
    "business_identity": "direct_customer",
    "business_industry": "Horticulture and Landscaping",
    "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

secondaryProfileSidstringOptional

addressSidstringOptional

addressDocumentSidstringOptional

businessInfoEndUserSidstringOptional

ar1EndUserSidstringOptional

ar2EndUserSidstringOptional

trustProductSidstringOptional

secondaryProfileStatusenumOptional

trustProductStatusenumOptional

lastEvaluationErrorsany or nullOptional

Parsed evaluation errors from Twilio, or null

lastUpdateddatetimeOptional

Errors

400

Bad Request Error

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error