Update a single associated person

curl --request PUT \
  --url https://api.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID} \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "first_name": "<string>",
  "middle_name": "<string>",
  "last_name": "<string>",
  "transliterated_first_name": "<string>",
  "transliterated_middle_name": "<string>",
  "transliterated_last_name": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "residential_address": {
    "street_line_1": "<string>",
    "street_line_2": "<string>",
    "city": "<string>",
    "subdivision": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  },
  "transliterated_residential_address": {
    "street_line_1": "<string>",
    "street_line_2": "<string>",
    "city": "<string>",
    "subdivision": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  },
  "birth_date": "<string>",
  "has_ownership": true,
  "has_control": true,
  "is_signer": true,
  "is_director": true,
  "title": "<string>",
  "ownership_percentage": 123,
  "attested_ownership_structure_at": "<string>",
  "relationship_established_at": "<string>",
  "verified_govid_at": "<string>",
  "verified_selfie_at": "<string>",
  "completed_customer_safety_check_at": "<string>",
  "identifying_information": [
    {
      "type": "drivers_license",
      "issuing_country": "<string>",
      "number": "<string>",
      "description": "<string>",
      "expiration": "<string>",
      "image_front": "<string>",
      "image_back": "<string>"
    }
  ],
  "documents": [
    {
      "purposes": [
        "proof_of_account_purpose"
      ],
      "file": "<string>",
      "description": "<string>"
    }
  ]
}'

{
  "id": "associated_person_1234567890",
  "email": "associated_person@business.co",
  "first_name": "John",
  "last_name": "Smith",
  "has_ownership": true,
  "has_control": true,
  "is_signer": true,
  "title": "Chief Executive Officer",
  "relationship_established_at": "2025-05-27T17:55:33.308Z",
  "created_at": "2025-05-27T17:55:33.308Z",
  "updated_at": "2025-05-27T17:55:33.308Z"
}

PUT

customers

{customerID}

associated_persons

{associatedPersonID}

Update a single associated person

curl --request PUT \
  --url https://api.bridge.xyz/v0/customers/{customerID}/associated_persons/{associatedPersonID} \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "first_name": "<string>",
  "middle_name": "<string>",
  "last_name": "<string>",
  "transliterated_first_name": "<string>",
  "transliterated_middle_name": "<string>",
  "transliterated_last_name": "<string>",
  "email": "<string>",
  "phone": "<string>",
  "residential_address": {
    "street_line_1": "<string>",
    "street_line_2": "<string>",
    "city": "<string>",
    "subdivision": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  },
  "transliterated_residential_address": {
    "street_line_1": "<string>",
    "street_line_2": "<string>",
    "city": "<string>",
    "subdivision": "<string>",
    "postal_code": "<string>",
    "country": "<string>"
  },
  "birth_date": "<string>",
  "has_ownership": true,
  "has_control": true,
  "is_signer": true,
  "is_director": true,
  "title": "<string>",
  "ownership_percentage": 123,
  "attested_ownership_structure_at": "<string>",
  "relationship_established_at": "<string>",
  "verified_govid_at": "<string>",
  "verified_selfie_at": "<string>",
  "completed_customer_safety_check_at": "<string>",
  "identifying_information": [
    {
      "type": "drivers_license",
      "issuing_country": "<string>",
      "number": "<string>",
      "description": "<string>",
      "expiration": "<string>",
      "image_front": "<string>",
      "image_back": "<string>"
    }
  ],
  "documents": [
    {
      "purposes": [
        "proof_of_account_purpose"
      ],
      "file": "<string>",
      "description": "<string>"
    }
  ]
}'

{
  "id": "associated_person_1234567890",
  "email": "associated_person@business.co",
  "first_name": "John",
  "last_name": "Smith",
  "has_ownership": true,
  "has_control": true,
  "is_signer": true,
  "title": "Chief Executive Officer",
  "relationship_established_at": "2025-05-27T17:55:33.308Z",
  "created_at": "2025-05-27T17:55:33.308Z",
  "updated_at": "2025-05-27T17:55:33.308Z"
}

Authorizations

Api-Key

string

header

required

Path Parameters

customerID

string

required

A UUID that uniquely identifies a resource

Required string length: 1 - 42

associatedPersonID

string

required

Unique identifier for an associated person

Required string length: 1 - 42

Body

application/json

Associated person data to update

first_name

string

required

The first name of the associated person

Required string length: 1 - 1024

last_name

string

required

The last name of the associated person

Required string length: 2 - 1024

string

required

The persons primary email address

Required string length: 1 - 1024

residential_address

object

required

The residential address of the associated person. This must be a physical address and cannot be a PO Box.

Show child attributes

birth_date

string

required

Date of birth in format yyyy-mm-dd. Must be at least 18 years old.

Required string length: 10

has_ownership

boolean

required

True if this person has at least 25% ownership of the business.

has_control

boolean

required

True if this is the control person of the company, having significant responsibility to control, manage or influence the activities of the business entity. At least one control person must be specified.

is_signer

boolean

required

True if this person is able to authorize transactions on behalf of the business. At least one signer must be specified.

identifying_information

Identification Information · object[]

required

Show child attributes

middle_name

string

The middle name of the associated person

Required string length: 1 - 1024

transliterated_first_name

string

Required when the first_name includes any non Latin-1 characters. Acceptable characters - Latin-1 Unicode Character Range: À-ÖØ-ßà-öø-ÿ; Standard Unicode Character Range: -~

Required string length: 1 - 256

transliterated_middle_name

string

Required when the middle_name includes any non Latin-1 characters. Acceptable characters - Latin-1 Unicode Character Range: À-ÖØ-ßà-öø-ÿ; Standard Unicode Character Range: -~

Required string length: 1 - 256

transliterated_last_name

string

Required when the last_name includes any non Latin-1 characters. Acceptable characters - Latin-1 Unicode Character Range: À-ÖØ-ßà-öø-ÿ; Standard Unicode Character Range: -~

Required string length: 1 - 256

phone

string

The persons phone in format "+12223334444"

Required string length: 1 - 1024

transliterated_residential_address

object

Required when any part of the residential_address includes any non Latin-1 characters. Acceptable characters - Latin-1 Unicode Character Range: À-ÖØ-ßà-öø-ÿ; Standard Unicode Character Range: -~

Show child attributes

is_director

boolean

True if this person is an appointed director of the company.

title

string

The title of this beneficial owner at the company, e.g. CEO, CFO, etc. Required if has_control is true.

Required string length: 1 - 1024

ownership_percentage

integer

Ultimate ownership percentage of the business.

attested_ownership_structure_at

string

The date or timestamp when this individual attested to the correctness of the ownership structure provided to Bridge. If provided by at least one control person, ownership documents for the business are not required.

relationship_established_at

string

The date or timestamp when the beneficial owner relationship was established in format yyyy-mm-dd.

verified_govid_at

string

The date or timestamp for when individual's government ID was successfully verified.

verified_selfie_at

string

The date or timestamp for when individual's selfie was successfully verified.

completed_customer_safety_check_at

string

The date or timestamp for when individual successfully passed customer safety check.

documents

Documents · object[]

Please click "ADD OBJECT" for more information.

Show child attributes

Response

Updated associated person

string

required

Unique identifier for the associated person

created_at

integer

required

Created timestamp in milliseconds since Unix epoch

updated_at

integer

required

Last updated timestamp in milliseconds since Unix epoch

string

The email address of the associated person

first_name

string

The first name of the associated person

Required string length: 2 - 1024

last_name

string

The last name of the associated person

Required string length: 2 - 1024

has_ownership

boolean

True if this person has at least 25% ownership of the business.

has_control

boolean

True if this is the control person of the company, having significant responsibility to control, manage or influence the activities of the business entity.

is_signer

boolean

True if this person is able to authorize transactions on behalf of the business.

title

string

The title of this associated person at the company, e.g. CEO, CFO, etc.

attested_ownership_structure_at

string

When this individual attested to the correctness of the ownership structure provided to Bridge. If provided by at least one control person, ownership documents for the business are not required.

relationship_established_at

string

When the associated person relationship was established in format yyyy-mm-dd.

Get a single associated person (Beta)Delete a single associated person

⌘I

Endpoints

Authorizations

Path Parameters

Body

Response