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": "LLC",
    "business_registration_number": "IL123456789",
    "business_name": "Greenleaf Gardens LLC",
    "business_registration_identifier": "REG-987654321",
    "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": "Johnson",
    "email": "emily.johnson@greenleafgardens.com",
    "phone_number": "+12175551234",
    "business_title": "Chief Operating Officer",
    "job_position": "Operations Manager"
  }
}'

{
  "secondaryProfileSid": "SP1234567890abcdef",
  "addressSid": "AD0987654321fedcba",
  "addressDocumentSid": "DOC1122334455aabbcc",
  "businessInfoEndUserSid": "EU5566778899ddeeff",
  "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

trustProductStatusenum

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