v1

latestOpenAPI 3.1.02026-07-226250251.5 KB

Customers

Attach Documents to Individual Customer V2

Attach identifying and address documents to an existing v2 individual customer. Replaces the v1 proof_of_identity / proof_of_address structure with separate identifying_documents and address_documents arrays. Documents are processed asynchronously.

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

Path parameters

customer_idstring uuid required

Unique identifier for the individual 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/individual. Signifies the customer has accepted the Terms of Service.

Example request

{
  "identifying_documents": [
    {
      "type": "PASSPORT",
      "number": "A12345678",
      "country": "USA",
      "state": "US-CA",
      "issue_date": "2020-01-15",
      "expiry_date": "2030-01-15",
      "files": [
        {
          "side": "FRONT",
          "uri": "/AbAcQ4hn_0652746727637.pdf"
        }
      ]
    }
  ],
  "address_documents": [
    {
      "type": "BANK_STATEMENT",
      "country": "USA",
      "issue_date": "2024-06-15",
      "files": [
        {
          "side": "FRONT",
          "uri": "/XyZ123mn_0652746727639.pdf"
        }
      ]
    }
  ],
  "tos_policies_value": "e9414388-fbdf-4407-b5c2-bc39eae3645b"
}

Response

Request validated and queued for asynchronous processing

metaobject nullable

Example response

{
  "data": {
    "customer_id": "55bd6b4e-c20a-4cc8-9535-91d5557a67d9"
  }
}