---
title: "KYC Account Status"
method: GET
path: "/v3/kyc/account-status"
tags: ["KYC"]
---

# KYC Account Status

`GET /v3/kyc/account-status`

## Request

- Base URL: `https://sandbox-api.transfi.com`
- URL: `https://sandbox-api.transfi.com/v3/kyc/account-status`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/transfi/apis/transfi-single-integrated-api/docs/v3/kyc/account-status/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the KYC verification status of an individual user for each role they hold - `sender` (funding an order) and `recipient` (being paid) - so a user cleared in one role can be told apart from one that is not. A role's `kyc` is `null` when the user holds no KYC record for it. Use `GET /v3/kyb/account-status` for business users.

## Query parameters

- `userId` string, required
- `accountType` 'sender' | 'recipient' | 'both'

## Headers

- `MID` string, required

## Response `200`

OK

- object
  - `status` string, required: `success` when the status lookup succeeded.
  - `data` object, required
    - `userId` string, required: The individual user the returned statuses belong to.
    - `accountType` 'sender' | 'recipient' | 'both', required: The role scope applied to the lookup; `both` when the query parameter is omitted.
    - `sender` object: Sender-side verification, present only when `accountType` is `sender` or `both`.
      - `kyc` object, nullable, required: Sender KYC status by tier, or `null` when the user holds no sender-side KYC record.
        - `basicKycStatus` string, nullable: Status of the basic (entry-level) identity screening tier.
        - `standardKycStatus` string, nullable: Status of the standard KYC tier, submitted via `POST /v3/kyc/standard`.
        - `advancedKycStatus` string, nullable: Status of the advanced KYC tier, submitted via `POST /v3/kyc/advanced`.
        - `failureMessage` string, nullable: Optional. Reason a tier could not be completed.
        - `rejectionDetails` string, nullable: Optional. Further detail on why a tier was rejected.
    - `recipient` object: Recipient-side verification, present only when `accountType` is `recipient` or `both`.
      - `kyc` object, nullable, required: Recipient KYC status by tier, or `null` when the user holds no recipient-side KYC record.
        - `basicKycStatus` string, nullable: Status of the basic (entry-level) identity screening tier.
        - `standardKycStatus` string, nullable: Status of the standard KYC tier, submitted via `POST /v3/kyc/standard`.
        - `advancedKycStatus` string, nullable: Status of the advanced KYC tier, submitted via `POST /v3/kyc/advanced`.
        - `failureMessage` string, nullable: Optional. Reason a tier could not be completed.
        - `rejectionDetails` string, nullable: Optional. Further detail on why a tier was rejected.
  - `traceId` string: Identifier of the request, useful when reporting an issue to TransFi support.

## Other responses

- `400`: Bad Request

## Changes

- **2026-11-03** `7b745621a79f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/transfi/apis/transfi-single-integrated-api/changes/v3/kyc/account-status/get.md)

---

[API](https://skmtc.dev/transfi/apis/transfi-single-integrated-api.md) - [All operations](https://skmtc.dev/transfi/apis/transfi-single-integrated-api/llms.txt) - [OpenAPI document](https://skmtc.dev/transfi/apis/transfi-single-integrated-api/revisions/7b745621a79f?raw)