---
title: "Update Account Owner"
method: PATCH
path: "/owners/{uuid}/"
tags: ["Account Owners"]
---

# Update Account Owner

`PATCH /owners/{uuid}/`

Update an existing account owner. Every data field can be updated except tax_id. Documents can be added or replaced: a replaced document is kept and marked superseded, never modified or deleted. Every change is recorded: data snapshots in versions, document changes in change_log.

## Path parameters

- `uuid` string, required

## Headers

- `x-company-id` integer — ID of a child company for authentication. If not provided, the parent company will be authenticated.

## Request body

- UpdateAccountOwnerRequest
  - `individual` UpdateIndividualDataSchema — Partial update of an individual owner: every data field is optional and only the provided ones are applied. tax_id cannot be updated.
    - `identity_document_id` string — ID of the uploaded document for KYC verification (if applicable). The supported document types are: NATIONAL_ID, PASSPORT, DRIVERS_LICENSE
    - `selfie_document_id` string — ID of the uploaded selfie for KYC verification (if applicable). The supported document type is: SELFIE
    - `proof_of_address_document_id` string — ID of the uploaded proof of address document for KYC verification (if applicable). The supported document type is: PROOF_OF_ADDRESS
    - `source_of_funds_document_id` string — ID of the uploaded source of funds document for KYC verification (if applicable). The supported document type is: SOURCE_OF_FUNDS
    - `other_documents` string[] — IDs of additional uploaded supporting documents (if applicable). The supported document type is: OTHER
    - `first_name` string — First name
    - `last_name` string — Last name
    - `date_of_birth` string — Date of birth (YYYY-MM-DD)
    - `tax_id` string — Not updatable: the tax ID identifies the owner with providers
    - `tax_id_country` string — Country code for tax ID (ISO 3166-1 alpha-2)
    - `additional_tax_id` string — Additional tax ID if required by provider
    - `email` string — Email address
    - `phone_number` string — Phone number with country code. Example: +5491133334444
    - `address` AddressSchema
      - `line_1` string, required — Address line 1
      - `city` string, required — City
      - `state` string, required — State or province
      - `postal_code` string, required — Postal code
      - `country` string, required — Country code (ISO 3166-1 alpha-2)
    - `expected_monthly_volume_usd` number — Self-declared expected monthly volume in USD
  - `organization` UpdateOrganizationDataSchema — Partial update of an organization owner: every data field is optional and only the provided ones are applied. tax_id cannot be updated. When provided, ultimate_beneficial_owners replaces the whole list (entries must be complete).
    - `incorporation_document_id` string — ID of the uploaded certificate of incorporation for KYC verification (if applicable). The supported document type is: CERTIFICATE_OF_INCORPORATION
    - `source_of_funds_document_id` string — ID of the uploaded source of funds document for KYC verification (if applicable). The supported document type is: SOURCE_OF_FUNDS
    - `proof_of_address_document_id` string — ID of the uploaded proof of address document for KYC verification (if applicable). The supported document type is: PROOF_OF_ADDRESS
    - `ownership_structure_document_id` string — ID of the uploaded ownership structure document for KYB verification (if applicable). The supported document type is: OWNERSHIP_STRUCTURE
    - `tax_registration_document_id` string — ID of the uploaded tax registration document for KYB verification (if applicable). The supported document type is: TAX_REGISTRATION
    - `corporate_org_chart_document_id` string — ID of the uploaded corporate organizational chart document for KYB verification (if applicable). The supported document type is: CORPORATE_ORG_CHART
    - `other_documents` string[] — IDs of additional uploaded supporting documents (if applicable). The supported document type is: OTHER
    - `name` string — Organization name
    - `date_of_incorporation` string — Date of incorporation (YYYY-MM-DD)
    - `tax_id` string — Not updatable: the tax ID identifies the owner with providers
    - `tax_id_country` string — Country code for tax ID (ISO 3166-1 alpha-2)
    - `email` string — Email address
    - `phone_number` string — Phone number with country code. Example: +5491133334444
    - `address` AddressSchema
      - `line_1` string, required — Address line 1
      - `city` string, required — City
      - `state` string, required — State or province
      - `postal_code` string, required — Postal code
      - `country` string, required — Country code (ISO 3166-1 alpha-2)
    - `expected_monthly_volume_usd` number — Self-declared expected monthly volume in USD
    - `ultimate_beneficial_owners` IndividualDataSchema[] — List of ultimate beneficial owners (UBOs). Replaces the whole list when provided
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `date_of_birth` string, required — Date of birth (YYYY-MM-DD)
      - `tax_id` string, required — Tax identification number
      - `tax_id_country` string, required — Country code for tax ID (ISO 3166-1 alpha-2)
      - `additional_tax_id` string — Additional tax ID if required by provider
      - `email` string, required — Email address
      - `phone_number` string, required — Phone number with country code. Example: +5491133334444
      - `address` AddressSchema, required
        - `line_1` string, required — Address line 1
        - `city` string, required — City
        - `state` string, required — State or province
        - `postal_code` string, required — Postal code
        - `country` string, required — Country code (ISO 3166-1 alpha-2)
      - `identity_document_id` string — ID of the uploaded document for KYC verification (if applicable). The supported document types are: NATIONAL_ID, PASSPORT, DRIVERS_LICENSE
      - `selfie_document_id` string — ID of the uploaded selfie for KYC verification (if applicable). The supported document type is: SELFIE
      - `proof_of_address_document_id` string — ID of the uploaded proof of address document for KYC verification (if applicable). The supported document type is: PROOF_OF_ADDRESS
      - `source_of_funds_document_id` string — ID of the uploaded source of funds document for KYC verification (if applicable). The supported document type is: SOURCE_OF_FUNDS
      - `other_documents` string[] — IDs of additional uploaded supporting documents (if applicable). The supported document type is: OTHER
      - `expected_monthly_volume_usd` number — Self-declared expected monthly volume in USD. Only accepted when kyc_mode is SELF_DECLARED

## Response `200`

Successful Response

- AccountOwnerSuccessResponse
  - `status` 'success'
  - `data` AccountOwnerResponse, required
    - `id` string, required — Account owner ID (UUID)
    - `created_at` string, date-time, required — Creation timestamp
    - `updated_at` string, date-time, required — Last update timestamp
    - `type` 'INDIVIDUAL' | 'ORGANIZATION', required — Type of account owner
    - `kyc_mode` 'SELF_DECLARED' | 'HOSTED' | 'EXTERNAL', required — KYC verification mode
    - `status` 'PENDING' | 'COMPLETED' | 'FAILED', required — KYC status
    - `level` 'BASIC' | 'STANDARD' | 'ENHANCED', required — KYC level
    - `individual` IndividualDataSchema
      - `first_name` string, required — First name
      - `last_name` string, required — Last name
      - `date_of_birth` string, required — Date of birth (YYYY-MM-DD)
      - `tax_id` string, required — Tax identification number
      - `tax_id_country` string, required — Country code for tax ID (ISO 3166-1 alpha-2)
      - `additional_tax_id` string — Additional tax ID if required by provider
      - `email` string, required — Email address
      - `phone_number` string, required — Phone number with country code. Example: +5491133334444
      - `address` AddressSchema, required
        - `line_1` string, required — Address line 1
        - `city` string, required — City
        - `state` string, required — State or province
        - `postal_code` string, required — Postal code
        - `country` string, required — Country code (ISO 3166-1 alpha-2)
      - `identity_document_id` string — ID of the uploaded document for KYC verification (if applicable). The supported document types are: NATIONAL_ID, PASSPORT, DRIVERS_LICENSE
      - `selfie_document_id` string — ID of the uploaded selfie for KYC verification (if applicable). The supported document type is: SELFIE
      - `proof_of_address_document_id` string — ID of the uploaded proof of address document for KYC verification (if applicable). The supported document type is: PROOF_OF_ADDRESS
      - `source_of_funds_document_id` string — ID of the uploaded source of funds document for KYC verification (if applicable). The supported document type is: SOURCE_OF_FUNDS
      - `other_documents` string[] — IDs of additional uploaded supporting documents (if applicable). The supported document type is: OTHER
      - `expected_monthly_volume_usd` number — Self-declared expected monthly volume in USD. Only accepted when kyc_mode is SELF_DECLARED
    - `organization` OrganizationDataSchema
      - `name` string, required — Organization name
      - `date_of_incorporation` string, required — Date of incorporation (YYYY-MM-DD)
      - `tax_id` string, required — Tax identification number
      - `tax_id_country` string, required — Country code for tax ID (ISO 3166-1 alpha-2)
      - `email` string, required — Email address
      - `phone_number` string, required — Phone number with country code. Example: +5491133334444
      - `address` AddressSchema, required
        - `line_1` string, required — Address line 1
        - `city` string, required — City
        - `state` string, required — State or province
        - `postal_code` string, required — Postal code
        - `country` string, required — Country code (ISO 3166-1 alpha-2)
      - `incorporation_document_id` string — ID of the uploaded certificate of incorporation for KYC verification (if applicable). The supported document type is: CERTIFICATE_OF_INCORPORATION
      - `source_of_funds_document_id` string — ID of the uploaded source of funds document for KYC verification (if applicable). The supported document type is: SOURCE_OF_FUNDS
      - `proof_of_address_document_id` string — ID of the uploaded proof of address document for KYC verification (if applicable). The supported document type is: PROOF_OF_ADDRESS
      - `ownership_structure_document_id` string — ID of the uploaded ownership structure document for KYB verification (if applicable). The supported document type is: OWNERSHIP_STRUCTURE
      - `tax_registration_document_id` string — ID of the uploaded tax registration document for KYB verification (if applicable). The supported document type is: TAX_REGISTRATION
      - `corporate_org_chart_document_id` string — ID of the uploaded corporate organizational chart document for KYB verification (if applicable). The supported document type is: CORPORATE_ORG_CHART
      - `other_documents` string[] — IDs of additional uploaded supporting documents (if applicable). The supported document type is: OTHER
      - `expected_monthly_volume_usd` number — Self-declared expected monthly volume in USD. Only accepted when kyc_mode is SELF_DECLARED
      - `ultimate_beneficial_owners` IndividualDataSchema[] — List of ultimate beneficial owners (UBOs)
        - `first_name` string, required — First name
        - `last_name` string, required — Last name
        - `date_of_birth` string, required — Date of birth (YYYY-MM-DD)
        - `tax_id` string, required — Tax identification number
        - `tax_id_country` string, required — Country code for tax ID (ISO 3166-1 alpha-2)
        - `additional_tax_id` string — Additional tax ID if required by provider
        - `email` string, required — Email address
        - `phone_number` string, required — Phone number with country code. Example: +5491133334444
        - `address` AddressSchema, required
          - `line_1` string, required — Address line 1
          - `city` string, required — City
          - `state` string, required — State or province
          - `postal_code` string, required — Postal code
          - `country` string, required — Country code (ISO 3166-1 alpha-2)
        - `identity_document_id` string — ID of the uploaded document for KYC verification (if applicable). The supported document types are: NATIONAL_ID, PASSPORT, DRIVERS_LICENSE
        - `selfie_document_id` string — ID of the uploaded selfie for KYC verification (if applicable). The supported document type is: SELFIE
        - `proof_of_address_document_id` string — ID of the uploaded proof of address document for KYC verification (if applicable). The supported document type is: PROOF_OF_ADDRESS
        - `source_of_funds_document_id` string — ID of the uploaded source of funds document for KYC verification (if applicable). The supported document type is: SOURCE_OF_FUNDS
        - `other_documents` string[] — IDs of additional uploaded supporting documents (if applicable). The supported document type is: OTHER
        - `expected_monthly_volume_usd` number — Self-declared expected monthly volume in USD. Only accepted when kyc_mode is SELF_DECLARED
    - `hosted` HostedVerificationSchema
      - `verification_url` string, required — URL to redirect the end user to in order to complete identity verification
      - `verification_url_expires_at` string, date-time, required — Expiration timestamp for the verification URL
    - `documents` DocumentVersionSchema[] — Every document linked to this owner (current and superseded), for versioning/audit
      - `id` string, required — Document ID (UUID)
      - `type` string, required — Document type
      - `status` 'CURRENT' | 'SUPERSEDED', required — CURRENT if this is the active document for its slot; SUPERSEDED if replaced by a newer one
      - `created_at` string, date-time, required — When the document was linked to the owner
      - `superseded_at` string, date-time — When this document was replaced (null while CURRENT)
      - `superseded_by_id` string — ID (UUID) of the document that replaced this one (null while CURRENT)
    - `change_log` ChangeLogEntrySchema[] — Append-only audit trail of every document change (at creation and via updates)
      - `action` 'DOCUMENT_ADDED' | 'DOCUMENT_REPLACED', required — Type of change
      - `document_type` string, required — Document type affected
      - `previous_document_id` string — ID (UUID) of the document current before the change (null for DOCUMENT_ADDED)
      - `new_document_id` string — ID (UUID) of the document that became current
      - `created_at` string, date-time, required — When the change happened
    - `versions` AccountOwnerVersionSchema[] — Snapshots of the owner's data over time, newest first (version 1 = state at creation)
      - `version` integer, required — Sequential version number (1 = state at creation)
      - `individual` object — Individual data at this version (owners of type INDIVIDUAL)
      - `organization` object — Organization data at this version (owners of type ORGANIZATION)
      - `created_at` string, date-time, required — When this version was created

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/infiniaweb/apis/payins.md) · [All operations](https://skmtc.net/infiniaweb/apis/payins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/infiniaweb/payins/versions/3f453785c478/schema)