--- title: "Get Account Owner" method: GET path: "/owners/{uuid}/" tags: ["Account Owners"] --- # Get Account Owner `GET /owners/{uuid}/` ## Request - Base URL: `https://app2test.infiniaweb.com/infinia_api/v1/accounts` - URL: `https://app2test.infiniaweb.com/infinia_api/v1/accounts/owners/{uuid}/` - Auth: HTTP basic Retrieves a specific account owner by its UUID. ## 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. ## 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 - `failure_reason` string: Reason of the failure, if the KYC verification failed - `callback_url` string: URL notified via webhook when the KYC verification reaches a final status - `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: Number of a government-issued identity document that identifies the individual (national ID, cédula, passport, driver's license, state ID). A tax-agency number is not required. Argentina: DNI here and CUIL in additional_tax_id - `tax_id_country` string, required: Country code for tax ID (ISO 3166-1 alpha-2) - `additional_tax_id` string: Additional identifier when the country requires one. Argentina: CUIL - `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 - `line_2` string: Address line 2 - `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) - `gender` 'MALE' | 'FEMALE' | 'UNSPECIFIED' - `employment_status` 'EMPLOYED' | 'SELF_EMPLOYED' | 'UNEMPLOYED' | 'STUDENT' | 'HOMEMAKER' | 'RETIRED' - `occupation_code` string: Occupation as a detailed code of the US Standard Occupational Classification 2018 (e.g. '15-1252' for software developers) - `employer_name` string: Employer name - `marital_status` 'SINGLE' | 'MARRIED' | 'DIVORCED' | 'WIDOWED' | 'DOMESTIC_PARTNERSHIP' - `spouse` SpouseSchema - `first_name` string, required: Spouse first name - `last_name` string, required: Spouse last name - `tax_id` string, required: Number of a government-issued identity document of the spouse - `tax_id_country` string, required: Country code for the spouse tax ID (ISO 3166-1 alpha-2) - `is_pep` boolean: Whether the individual is a politically exposed person - `is_aml_obligated_subject` boolean: Whether the individual is an obligated subject under the anti-money laundering law of their country. Argentina: an obligated subject before the UIF under article 20 of Law 25,246 - `is_us_person` boolean: Whether the individual is a U.S. person for federal tax purposes (FATCA): a U.S. citizen, a green card holder or a U.S. tax resident under the substantial presence test - `tax_residencies` TaxResidenceSchema[]: Every country where the individual is a tax resident, with the tax identification number issued there, as self-certified for the OECD Common Reporting Standard (CRS) - `country` string, required: Country where the individual is a tax resident (ISO 3166-1 alpha-2) - `tax_id` string: Tax identification number issued by that country - `account_purpose` 'RECEIVE_SALARY' | 'RECEIVE_FREELANCE_PAYMENTS' | 'PERSONAL_OR_LIVING_EXPENSES' | 'PAYMENTS_TO_FAMILY_OR_FRIENDS' | 'PURCHASE_GOODS_AND_SERVICES' | 'SAVINGS_OR_INVESTMENT' | 'VIRTUAL_ASSETS_TRADING' | 'ARBITRAGE' | 'OPERATING_A_BUSINESS' | 'OTHER' - `account_purpose_other` string: Purpose of the account in your own words, for OTHER - `biometric_check_performed` boolean: Whether you verified the individual with a biometric check, such as a selfie with liveness detection matched against the identity document - `government_database_check_performed` boolean: Whether you validated the individual's identity data against a government database, such as the national identity or tax registry - `identity_document_id` string: ID of the uploaded document for KYC verification (if applicable). The supported document types are: NATIONAL_ID, PASSPORT, DRIVERS_LICENSE. State IDs and residence permits are uploaded as NATIONAL_ID - `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` OrganizationDataSchemaOutput - `name` string, required: Organization name - `date_of_incorporation` string, required: Date of incorporation (YYYY-MM-DD) - `tax_id` string, required: Company tax identification / registration number (e.g. CNPJ, NIT, EIN) - `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 - `line_2` string: Address line 2 - `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: Number of a government-issued identity document that identifies the individual (national ID, cédula, passport, driver's license, state ID). A tax-agency number is not required. Argentina: DNI here and CUIL in additional_tax_id - `tax_id_country` string, required: Country code for tax ID (ISO 3166-1 alpha-2) - `additional_tax_id` string: Additional identifier when the country requires one. Argentina: CUIL - `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 - `line_2` string: Address line 2 - `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) - `gender` 'MALE' | 'FEMALE' | 'UNSPECIFIED' - `employment_status` 'EMPLOYED' | 'SELF_EMPLOYED' | 'UNEMPLOYED' | 'STUDENT' | 'HOMEMAKER' | 'RETIRED' - `occupation_code` string: Occupation as a detailed code of the US Standard Occupational Classification 2018 (e.g. '15-1252' for software developers) - `employer_name` string: Employer name - `marital_status` 'SINGLE' | 'MARRIED' | 'DIVORCED' | 'WIDOWED' | 'DOMESTIC_PARTNERSHIP' - `spouse` SpouseSchema - `first_name` string, required: Spouse first name - `last_name` string, required: Spouse last name - `tax_id` string, required: Number of a government-issued identity document of the spouse - `tax_id_country` string, required: Country code for the spouse tax ID (ISO 3166-1 alpha-2) - `is_pep` boolean: Whether the individual is a politically exposed person - `is_aml_obligated_subject` boolean: Whether the individual is an obligated subject under the anti-money laundering law of their country. Argentina: an obligated subject before the UIF under article 20 of Law 25,246 - `is_us_person` boolean: Whether the individual is a U.S. person for federal tax purposes (FATCA): a U.S. citizen, a green card holder or a U.S. tax resident under the substantial presence test - `tax_residencies` TaxResidenceSchema[]: Every country where the individual is a tax resident, with the tax identification number issued there, as self-certified for the OECD Common Reporting Standard (CRS) - `country` string, required: Country where the individual is a tax resident (ISO 3166-1 alpha-2) - `tax_id` string: Tax identification number issued by that country - `account_purpose` 'RECEIVE_SALARY' | 'RECEIVE_FREELANCE_PAYMENTS' | 'PERSONAL_OR_LIVING_EXPENSES' | 'PAYMENTS_TO_FAMILY_OR_FRIENDS' | 'PURCHASE_GOODS_AND_SERVICES' | 'SAVINGS_OR_INVESTMENT' | 'VIRTUAL_ASSETS_TRADING' | 'ARBITRAGE' | 'OPERATING_A_BUSINESS' | 'OTHER' - `account_purpose_other` string: Purpose of the account in your own words, for OTHER - `biometric_check_performed` boolean: Whether you verified the individual with a biometric check, such as a selfie with liveness detection matched against the identity document - `government_database_check_performed` boolean: Whether you validated the individual's identity data against a government database, such as the national identity or tax registry - `identity_document_id` string: ID of the uploaded document for KYC verification (if applicable). The supported document types are: NATIONAL_ID, PASSPORT, DRIVERS_LICENSE. State IDs and residence permits are uploaded as NATIONAL_ID - `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 - `404`: Not Found - `422`: Validation Error - `500`: Internal Server Error --- [API](https://skmtc.dev/infiniaweb/apis/accounts.md) - [All operations](https://skmtc.dev/infiniaweb/apis/accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/infiniaweb/apis/accounts/revisions/2faae77050e4?raw)