---
title: "Get account status"
method: GET
path: "account-status"
tags: ["Account Status"]
---

# Get account status

`GET account-status`

## Request

- Base URL: `https://payments.air-pay.io`
- URL: `https://payments.air-pay.io/account-status`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1/docs/account-status/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the current status of any user's account by providing their
email in the request headers. The response will return the user's client
ID, account status, whether the email corresponds to the primary account
(Airtm allows up to two secondary emails per account), the country where
the account is registered, the verification status, and the full name
registered on the account.

**The email parameter should be URL Encoded. You can learn more about
encoding urls here:**
[**https://www.w3schools.com/tags/ref\_urlencode.ASP**](https://www.w3schools.com/tags/ref_urlencode.ASP)

## Query parameters

- `email` string, required: Email associated with the account to check.

## Response `200`

OK

- object
  - `clientId` string: Unique Airtm identifier of the user associated with the email.
  - `status` string: The user's account status (active or inactive).
  - `isPrimary` boolean: Indicates if the queried email corresponds to the user's primary email
  - `country_ID` string: The ISO alpha-3 code for the country where the user's ID was issued
  - `is_verified` boolean: Indicates whether the user is verified (true or false)
  - `fullName` string: The user's full name as registered in Airtm

---

[API](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1.md) - [All operations](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/airtm/apis/airtm-enterprise-api-v1/revisions/4e8326a04343?raw)