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

# KYB Account Status

`GET /v3/kyb/account-status`

## Request

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

Retrieves the KYB verification status of a business user for each product role: `sender` (the party funding an order) and `recipient` (the party being paid). Each role block holds the individual KYB tiers, or `null` when the user holds no KYB record for that role. For the account-wide verdict and rejection labels, use `GET /v3/kyb/status/{userId}`.

## Query parameters

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

## Headers

- `MID` string, required

## Response `200`

OK

- object
  - `status` string, required: Always `success` for a 2xx response.
  - `data` object, required
    - `userId` string, required: The business user the returned statuses belong to.
    - `accountType` 'sender' | 'recipient' | 'both', required: The product role reported on; `both` when the query parameter was omitted.
    - `sender` object: Sender-side KYB, present only when `accountType` is `sender` or `both`.
      - `kyb` object, nullable, required: KYB tier statuses for the sender role, or `null` when the user has no sender-side KYB record.
        - `basicKybStatus` string, nullable: Status of the basic (entry-level) business screening, which must be `approved` before a standard or advanced KYB submission is accepted.
        - `simplifiedKybStatus` string, nullable: Status of the simplified KYB tier, where `kyb_success` counts as standard KYB already completed.
        - `standardKybStatus` string, nullable: Status of the standard KYB tier.
        - `advancedKybStatus` string, nullable: Status of the advanced KYB tier, submitted via `POST /v3/kyb/advanced`.
        - `combinedKybStatus` string, nullable: Status of the combined KYB tier.
    - `recipient` object: Recipient-side KYB, present only when `accountType` is `recipient` or `both`.
      - `kyb` object, nullable, required: KYB tier statuses for the recipient role, or `null` when the user has no recipient-side KYB record.
        - `basicKybStatus` string, nullable: Status of the basic (entry-level) business screening, which must be `approved` before a standard or advanced KYB submission is accepted.
        - `simplifiedKybStatus` string, nullable: Status of the simplified KYB tier, where `kyb_success` counts as standard KYB already completed.
        - `standardKybStatus` string, nullable: Status of the standard KYB tier.
        - `advancedKybStatus` string, nullable: Status of the advanced KYB tier, submitted via `POST /v3/kyb/advanced`.
        - `combinedKybStatus` string, nullable: Status of the combined KYB tier.
  - `traceId` string: Correlation id for this request. Quote it when contacting 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/kyb/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)