---
title: "[V2] Get user"
method: GET
path: "/api/v2/user"
tags: ["User Management"]
---

# [V2] Get user

`GET /api/v2/user`

Retrieves extended user account information including verification status, documents, external provider integrations, and available capabilities.

## Response `200`

OK

- ResponseUserResponseV2
  - `capabilities` ResponseCapability[] — List of capabilities available to the user
    - `prerequisites` ResponseCapabilityType[] — Capabilities that should be activated before this capability can be used
    - `status` 'Active' | 'ActivationNotStarted' | 'InProgress' | 'NotFulfilled' | 'NotRequired' | 'NotAvailable', required
    - `status_reason` string — Reason for the capability status. May be empty or may contain a message explaining the status
    - `type` 'SepaAccount' | 'SepaIn1stParty' | 'SepaIn3rdParty' | 'SepaOut1stParty' | 'SepaOut3rdParty' | 'AchAccount' | 'AchIn1stParty' | 'AchIn3rdParty' | 'AchOut1stParty' | 'AchOut3rdParty' | 'SpeiAccount' | 'SpeiIn1stParty' | 'SpeiIn3rdParty' | 'SpeiOut1stParty' | 'SpeiOut3rdParty' | 'FasterPaymentsAccount' | 'FasterPaymentsIn1stParty' | 'FasterPaymentsIn3rdParty' | 'FasterPaymentsOut1stParty' | 'FasterPaymentsOut3rdParty' | 'VisaPlasticCard' | 'VisaVirtualCard' | 'BridgePlasticCard' | 'BridgeVirtualCard' | 'CardTransfer' | 'CardTopup' | 'CpnExternalProfile' | 'PixOut3rdParty' | 'FpsHkOut3rdParty' | 'FedwireOut3rdParty' | 'SwiftOut3rdParty' | 'CipsOut3rdParty' | 'ChatsOut3rdParty' | 'TripleAExternalProfile' | 'ImpsOut3rdParty' | 'InstapayOut3rdParty' | 'BiFastOut3rdParty' | 'NipOut3rdParty' | 'IppOut3rdParty' | 'PseOut3rdParty' | 'StableExchange' | 'VisaMetalCard' | 'SavingsAccount' | 'Loan', required
    - `verification_requirements` ResponseVerificationLevelRequirement[] — Verification levels required to use this capability
      - `order` integer, required — Order of the verification level in the list
      - `type` 'N/A' | 'BDD' | 'SDD' | 'XDDBridge' | 'EDD', required
  - `chain_id` integer — Chain ID where the user account was registered
  - `external_providers` ResponseUserExternalProviderV2[] — List of external provider integrations
    - `account_id` string — External account identifier at the provider - present when linked
    - `cpn` ResponseUserCpnProviderV2
      - `address_line1` string — Primary address line
      - `address_line2` string — Secondary address line
      - `city` string — City name
      - `country` string — Country as ISO 3166-1 alpha-2 country code
      - `country_of_residence` string — Country of residence as ISO 3166-1 alpha-2 country code
      - `date_of_birth` string — Date of birth in YYYY-MM-DD format
      - `national_id` string — National id document number
      - `national_id_issuer` string — Issuer of the national id document
      - `national_id_type` string — Type of the national id document
      - `originator_account_number` string — Originator account number
      - `originator_address` ResponseUserPostalAddressV2
        - `city` string — City name
        - `country` string — Country as ISO 3166-1 alpha-2 country code
        - `line1` string — Primary address line (street address)
        - `line2` string — Secondary address line (apartment, suite, unit, etc.) - optional
        - `post_code` string — Postal or ZIP code
        - `region` string — State, province or region - optional
      - `originator_country_of_formation` string — Originator country of formation - optional, present for legal entities
      - `originator_date_of_formation` string — Originator date of formation - optional, present for legal entities
      - `originator_name` string — Originator full name
      - `originator_national_identification_number` string — Originator national identification number
      - `originator_phone_number` string — Originator phone number - optional
      - `place_of_birth` string — Place of birth
      - `post_code` string — Postal or ZIP code
      - `primary_identifier` string — Primary identifier assigned by CPN
      - `secondary_identifier` string — Secondary identifier assigned by CPN
    - `freshdesk` ResponseUserFreshdeskProviderV2
      - `chat_token` string — Freshdesk chat token used to authenticate the user into the support widget
    - `triplea` ResponseUserTripleAProviderV2
      - `document_data_hash` string — Hash of the document data submitted to Triple-A
      - `individual_id` string — Triple-A individual id linked to this account
      - `personal_data_hash` string — Hash of the personal data submitted to Triple-A
      - `verification_status` 'None' | 'Pending' | 'Approved' | 'Rejected' | 'InReview'
    - `type` 'Cpn' | 'Triplea' | 'WirexApp'
    - `wirex_app` ResponseUserWirexAppProviderV2
      - `migration_stage` 'None' | 'User' | 'Verification' | 'Cards' | 'Accounts' | 'Balances' | 'Loans' | 'Savings'
      - `migration_status` 'NotMigrated' | 'MigrationAccepted' | 'InProgress' | 'Completed' | 'Failed' | 'Impossible'
      - `sumsub_id` string — SumSub applicant id imported from Wirex App during verification migration
      - `user_id` string — Wirex App user id this account was/will be migrated from
  - `id` string — Deprecated: still populated for backward compatibility, but consumers should read user_id — this field carries the user's UUID, which is now exposed as user_id.
  - `owner` string — Deprecated: still populated for backward compatibility, but consumers should read user_address — this field carries the user's EOA, which is now exposed as user_address.
  - `profile` ResponseUserProfileV2
    - `date_of_birth` string — Date of birth in YYYY-MM-DD format
    - `email` string — Email address of the user
    - `first_name` string — First name of the user as provided during KYC registration
    - `last_name` string — Last name of the user as provided during KYC registration
    - `nationality` string — Nationality as ISO 3166-1 alpha-2 country code
    - `phone_number` string — Phone number with country code in international format
    - `status` 'Active' | 'Blocked' | 'Deleted' | 'Pending'
  - `residence_address` ResponseUserResidenceAddressV2
    - `city` string — City name
    - `country` string — Country as ISO 3166-1 alpha-2 country code
    - `line1` string — Primary address line (street address)
    - `line2` string — Secondary address line (apartment, suite, unit, etc.) - optional
    - `post_code` string — Postal or ZIP code
    - `state` string — State or province - optional, required for some countries
  - `user_address` string — EOA of the user that owns this account. Preferred field; owner mirrors the same value for backward compatibility.
  - `user_id` string — UserId is the UUID identifier of the user. Preferred field; id mirrors the same value for backward compatibility.
  - `verification` ResponseUserVerificationV2
    - `documents` ResponseUserDocumentV2[] — List of documents submitted for verification
      - `added_date` string — ISO 8601 timestamp when the document was uploaded
      - `file_type` string — File type/format of the uploaded document
      - `id` string — Unique identifier of the document
      - `type` string — Type of document (passport, identity_card, driver_license, proof_of_address)
    - `levels` ResponseUserVerificationLevelV2[] — List of verification levels and their statuses
      - `name` string — Human-readable name of the verification level
      - `status` 'None' | 'Pending' | 'Approved' | 'Rejected' | 'Canceled' | 'Applied' | 'InReview'
      - `type` 'N/A' | 'BDD' | 'SDD' | 'XDDBridge' | 'EDD'
    - `status` 'None' | 'Pending' | 'Approved' | 'Rejected' | 'Canceled' | 'Applied' | 'InReview'

## Other responses

- `400` — Bad Request
- `404` — User not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/wirexapp/apis/wirex-baas-api.md) · [All operations](https://skmtc.net/wirexapp/apis/wirex-baas-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wirexapp/wirex-baas-api/versions/b95a180790b1/schema)