Skip to main content
POST
/
v2
/
customers
/
{customer_id}
/
business
/
attach
Attach Documents to Business Customer V2
curl --request POST \
  --url https://sandbox.api.fin.com/v2/customers/{customer_id}/business/attach \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "formation_documents": [
    {
      "type": "EVIDENCE_OF_DIRECTORS_AND_CONTROLLERS",
      "description": "Certificate of Incorporation",
      "files": [
        {
          "uri": "/AbAcQ4hn_0652746727637.pdf"
        }
      ]
    },
    {
      "type": "REGISTRATION_DOCUMENT",
      "description": "Business registration doc",
      "files": [
        {
          "uri": "/AbAcQ4hn_0652746727638.pdf"
        }
      ]
    }
  ],
  "ownership_documents": [
    {
      "type": "PROOF_OF_SIGNATORY_AUTHORITY",
      "description": "Shareholder Registry",
      "files": [
        {
          "uri": "/XyZ123mn_0652746727639.pdf"
        }
      ]
    }
  ],
  "supporting_documents": [
    {
      "type": "PROOF_OF_SOURCE_OF_FUNDS",
      "files": [
        {
          "uri": "/PoAdef45_0652746727640.pdf"
        }
      ]
    },
    {
      "type": "PROOF_OF_ADDRESS",
      "files": [
        {
          "uri": "/PoAdef45_0652746727641.pdf"
        }
      ]
    }
  ],
  "tos_policies_value": "6955e70b-f9f3-4076-b1ce-5c897085dd24"
}
'
{
  "data": {}
}
Upload files first using POST /v1/customers/upload to obtain URIs, then reference them here.
Parse tos_policies_value from the tos_policies_url returned by POST /v2/customers/business and include it in this request.

​
Document Type Reference

See Entity-wise document requirement for all valid type values per category and entity type.

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
​
tos_policies_value
string
required

Parsed from the tos_policies_value query parameter in the tos_policies_url returned by POST /v2/customers/business. Signifies the customer has accepted the Terms of Service.

Example:

"f11e77c6-8dc0-4d4b-a3f2-ed84c8ccfc69"

​
formation_documents
object[]

Documents proving the legal existence of the business (e.g., Certificate of Incorporation, Articles of Incorporation, Trust Agreement, Tax registration certificate).

​
ownership_documents
object[]

Documents proving who controls and owns the business (e.g., Shareholder Register, Org Chart, Power of Attorney, Directors Registry).

​
supporting_documents
object[]

Additional compliance and operational documents (e.g., Proof of Address, Proof of Source of Funds, AML Comfort Letter, Marketing Materials).

Response

Documents attached successfully

​
data
object

Generic response object