Skip to main content
PATCH
/
v1
/
customers
/
{customer_id}
Update Customer
curl --request PATCH \
  --url https://sandbox.api.fin.com/v1/customers/{customer_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "ownership_documents": [
    {
      "type": "PROOF_OF_SIGNATORY_AUTHORITY",
      "description": "Shareholder Registry",
      "files": [
        {
          "uri": "/AbAcQ4hn_0652746727639.pdf"
        }
      ]
    }
  ],
  "formation_documents": [
    {
      "type": "REGISTRATION_DOCUMENT",
      "description": "Certificate of Incorporation",
      "files": [
        {
          "uri": "/AbAcQ4hn_0652746727637.pdf"
        }
      ]
    }
  ],
  "associated_party_attachments": [
    {
      "associated_party_id": "f6b13e01-044a-4f74-a70b-d5f66b6449af",
      "address_documents": [
        {
          "type": "UTILITY_BILL",
          "files": [
            {
              "uri": "/AbAcQ4hn_0652746727638.pdf"
            }
          ]
        }
      ]
    }
  ]
}
'
{
  "data": {
    "customer_id": "ed54db74-7dbe-47d2-8ea0-c2bf2a9dda06"
  }
}
Only submit the fields explicitly listed in the RFI. Sending unrequested fields will result in an error.
The request body accepts the same fields as the following endpoints:
  • Create Individual Customer
  • Create Business Customer V1
  • Create Business Customer V2
  • Attach Documents to Individual Customer
  • Attach Documents to Business Customer
  • Attach Documents to Business Customer V2
  • Attach Document To Associated Party
  • Attach Document To Associated Party V2

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
customer_id
string<uuid>
required

Unique identifier of the customer to update

Body

application/json

Partial update payload. Include only the fields you want to update. The structure mirrors the payloads of the customer creation and document attachment endpoints.

​
associated_party_attachments
object[]

Document attachments for associated parties of a business customer

​
ownership_documents
object[]

Ownership documents for the business customer (e.g. shareholder registry, proof of signatory authority)

​
formation_documents
object[]

Formation documents for the business customer (e.g. certificate of incorporation, registration document)

​
supporting_documents
object[]

Supporting documents for the customer

Response

Customer updated successfully

​
data
object