---
title: "Get User Account Type"
method: GET
path: "/v3/users/account-type"
tags: ["Users"]
---

# Get User Account Type

`GET /v3/users/account-type`

## Request

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

Retrieves the account roles of an individual or business user as an array — `SENDER`, plus `RECIPIENT_FIAT` / `RECIPIENT_CRYPTO` derived from the user's payout account identifiers. A user can hold several roles at once. The user must belong to the MID in the header and must have been created through the sender or recipient creation APIs. Call it after a role change to confirm the new role took effect.

## Query parameters

- `userId` string, required

## Headers

- `MID` string, required

## Response `200`

OK

- object
  - `status` string
  - `data` object: The user's account roles.
    - `id` string: The user ID the account type was resolved for.
    - `entityType` string: The kind of entity the ID refers to.
    - `accountType` string[]: The user's roles — `SENDER` funds orders; `RECIPIENT_FIAT` / `RECIPIENT_CRYPTO` receive fiat / crypto payouts. A user can hold several roles at once. Omitted when the user has no roles yet.
  - `traceId` string

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

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

[Operation history](https://skmtc.dev/transfi/apis/transfi-single-integrated-api/changes/v3/users/account-type/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)