Skip to main content
POST
/
v1
/
customers
/
business
/
attach
Attach Documents to Business Customer
curl --request POST \
  --url https://sandbox.api.fin.com/v1/customers/business/attach \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_id": "55bd6b4e-c20a-4cc8-9535-91d5557a67d9",
  "ownership_structure": [
    {
      "type": "SHAREHOLDER_REGISTRY",
      "files": [
        {
          "uri": "/AbAcQ4hn_0652746727639.pdf"
        }
      ]
    }
  ],
  "company_details": [
    {
      "type": "CERT_OF_INCORPORATION",
      "files": [
        {
          "uri": "/AbAcQ4hn_0652746727640.pdf"
        }
      ]
    }
  ],
  "legal_presence": [
    {
      "type": "PROOF_OF_ADDRESS",
      "files": [
        {
          "uri": "/AbAcQ4hn_0652746727641.pdf"
        }
      ]
    }
  ],
  "tos_policies_value": "e9414388-fbdf-4407-b5c2-bc39eae3645b"
}
'
{
  "data": {}
}
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 Business 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"

​
ownership_structure
object[]
required

Array of ownership structure documents

​
company_details
object[]
required

Array of company detail documents

​
legal_presence
object[]
required

Array of legal presence documents

​
tos_policies_value
string
required

Terms of Service policies value parsed from the tos_policies_url query parameter returned from the Create Business 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

Generic response object