Skip to main content
POST
/
v2
/
customers
/
{customer_id}
/
associated-parties
/
individual
/
attach
Attach Documents to Associated Party V2
curl --request POST \
  --url https://sandbox.api.fin.com/v2/customers/{customer_id}/associated-parties/individual/attach \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "associated_party_attachments": [
    {
      "associated_party_id": "f6b13e01-044a-4f74-a70b-d5f66b6449af",
      "identifying_documents": [
        {
          "type": "PASSPORT",
          "number": "A12345678",
          "country": "USA",
          "issue_date": "2020-01-15",
          "expiry_date": "2030-01-15",
          "files": [
            {
              "uri": "/AbAcQ4hn_0652746727637.pdf"
            }
          ]
        },
        {
          "type": "DRIVERS_LICENSE",
          "number": "DL987654321",
          "country": "USA",
          "issue_date": "2019-06-01",
          "expiry_date": "2029-06-01",
          "files": [
            {
              "side": "FRONT",
              "uri": "/AbAcQ4hn_0652746727645.pdf"
            },
            {
              "side": "BACK",
              "uri": "/AbAcQ4hn_0652746727646.pdf"
            }
          ]
        }
      ],
      "address_documents": [
        {
          "type": "BANK_STATEMENT",
          "files": [
            {
              "uri": "/AbAcQ4hn_0652746727638.pdf"
            }
          ]
        }
      ],
      "supporting_documents": []
    },
    {
      "associated_party_id": "f71dc19f-b9a0-49fb-bd2d-5add3c01626e",
      "identifying_documents": [
        {
          "type": "NATIONAL_ID",
          "number": "NID-987654",
          "country": "USA",
          "issue_date": "2021-03-10",
          "expiry_date": "2031-03-10",
          "files": [
            {
              "side": "FRONT",
              "uri": "/XyZ123mn_0652746727650.pdf"
            },
            {
              "side": "BACK",
              "uri": "/XyZ123mn_0652746727651.pdf"
            }
          ]
        }
      ],
      "address_documents": [
        {
          "type": "UTILITY_BILL",
          "files": [
            {
              "uri": "/XyZ123mn_0652746727652.pdf"
            }
          ]
        }
      ]
    }
  ]
}
'
{
  "data": {}
}
Upload files first using POST /v1/customers/upload to obtain URIs, then reference them here.
The associated_party_id for each party is returned in the GET /v2/customers/:customer-id response.

​
Identity Document Side Requirements

TypeSides Required
PASSPORTNo (single image)
NATIONAL_IDYes — FRONT + BACK
DRIVERS_LICENSEYes — FRONT + BACK
RESIDENCE_PERMITNo (single image)

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
customer_id
string<uuid>
required

Unique identifier for the business customer

Body

application/json
​
associated_party_attachments
object[]
required

Array of document attachments, one entry per associated party. Multiple parties can be submitted in a single request.

Minimum array length: 1

Response

Documents attached successfully

​
data
object

Generic response object