Skip to main content
POST
/
v1
/
customers
/
associated-parties
/
individual
/
attach
Attach Document To Associated Party
curl --request POST \
  --url https://sandbox.api.fin.com/v1/customers/associated-parties/individual/attach \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_id": "55bd6b4e-c20a-4cc8-9535-91d5557a67d9",
  "associated_party_attachments": [
    {
      "associated_party_id": "a7c3b4e2-d8f1-4a5c-9e7d-2f6b8c3a1e9f",
      "proof_of_identity": {
        "type": "PASSPORT",
        "number": "A12345678",
        "country": "AFG",
        "issue_date": "2020-01-15",
        "expiry_date": "2030-01-15",
        "files": [
          {
            "uri": "/AbAcQ4hn_0652746727637.pdf",
            "side": "FRONT"
          }
        ]
      },
      "proof_of_address": {
        "type": "UTILITY_BILL",
        "country": "AFG",
        "files": [
          {
            "uri": "/AbAcQ4hn_0652746727638.pdf"
          }
        ]
      }
    }
  ]
}
'
{
  "data": {}
}
Before calling this endpoint, upload documents using the /v1/customers/upload endpoint to obtain the URIs needed for the files arrays.
This endpoint allows attaching documents for multiple associated parties in a single request.

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Obtain token from /v1/oauth/token endpoint

Body

application/json
​
customer_id
string<uuid>
required

Unique identifier for the customer

Example:

"55bd6b4e-c20a-4cc8-9535-91d5557a67d9"

​
associated_party_attachments
object[]
required

Array of document attachments for associated parties

Response

Documents attached successfully

​
data
object

Generic response object