Skip to main content
POST
/
v1
/
customers
/
individual
/
attach
Attach Documents to Individual Customer
curl --request POST \
  --url https://sandbox.api.fin.com/v1/customers/individual/attach \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_id": "55bd6b4e-c20a-4cc8-9535-91d5557a67d9",
  "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"
      }
    ]
  },
  "tos_policies_value": "e9414388-fbdf-4407-b5c2-bc39eae3645b"
}
'
{
  "data": {
    "customer_id": "55bd6b4e-c20a-4cc8-9535-91d5557a67d9"
  }
}
Before calling this endpoint, upload documents using the /v1/customers/upload endpoint to obtain the URIs needed for the files arrays.
The tos_policies_value should be parsed from the tos_policies_url query parameter returned from the Create Individual Customer endpoint.

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"

​
proof_of_identity
object
required
​
proof_of_address
object
required
​
tos_policies_value
string
required

Terms of Service policies value parsed from the tos_policies_url query parameter returned from the Create Individual Customer endpoint. Providing this signifies that the user was shown the policies and have accepted the terms.

Example:

"e9414388-fbdf-4407-b5c2-bc39eae3645b"

Response

Documents attached successfully

​
data
object