Sign in

v1

latestOpenAPI 3.1.02026-07-226250251.5 KB
Customers

Attach Documents to Business Customer V2

Attach formation, ownership, and supporting documents to an existing business customer. Documents are categorised into three arrays: formation_documents, ownership_documents, and supporting_documents, replacing the v1 ownership_structure / company_details / legal_presence structure.

post/v2/customers/{customer_id}/business/attach

Path parameters

customer_idstring uuid required

Unique identifier for the business customer

Request body

tos_policies_valuestring required

Parsed from the tos_policies_value query parameter in the tos_policies_url returned by POST /v2/customers/business. Signifies the customer has accepted the Terms of Service.

Example request

{
  "formation_documents": [
    {
      "type": "REGISTRATION_DOCUMENT",
      "description": "Certificate of Incorporation",
      "files": [
        {
          "uri": "/AbAcQ4hn_0652746727639.pdf"
        }
      ]
    }
  ],
  "ownership_documents": [
    {
      "type": "OWNERSHIP_INFORMATION",
      "description": "Ownership information document",
      "files": [
        {
          "uri": "/AbAcQ4hn_0652746727639.pdf"
        }
      ]
    }
  ],
  "supporting_documents": [
    {
      "type": "PROOF_OF_SOURCE_OF_FUNDS",
      "description": "Bank statements for the past 6 months",
      "files": [
        {
          "uri": "/AbAcQ4hn_0652746727639.pdf"
        }
      ]
    }
  ],
  "tos_policies_value": "f11e77c6-8dc0-4d4b-a3f2-ed84c8ccfc69"
}

Response

Documents attached successfully

dataobject

Generic response object