---
title: "Check performer verification status"
method: POST
path: "/api/v1/talent/check"
tags: ["Talent"]
---

# Check performer verification status

`POST /api/v1/talent/check`

## Request

- Base URL: `https://easy2257.com`
- URL: `https://easy2257.com/api/v1/talent/check`
- Auth: HTTP bearer

Answers one question about one of your own creators: are they verified right now. Scoped to accounts you provisioned, so it returns `found: false` for every address you did not, including creators verified through another platform. It cannot be used to discover whether an arbitrary email has an Easy2257 account, and it never returns a name, a date of birth, or an ID.

## Request body

- TalentCheckBody
  - `email` string, email, required: Matched case-insensitively against the exact address you provisioned. Plus-tags and dots are not folded here.

## Response `200`

Lookup result. A miss is a 200 with `found: false`, not a 404.

- TalentCheckResponse
  - `found` boolean, required: Whether this address matches an account you provisioned. Always false for anyone you did not provision, including creators verified through another platform.
  - `verified` boolean, required: True only when that account's status is `active`.
  - `lastVerifiedAt` string, nullable, required: Date of the most recent approved verification as `YYYY-MM-DD`, or null. Date only: no time, and no verification detail.

## Other responses

- `400`: `email` missing.
- `401`: No `Authorization: Bearer` header, or a key that is unknown, revoked, or expired. The body carries only `error`, never a `code`.
- `403`: Rejected before the handler: a test-mode key (`TEST_MODE_UNAVAILABLE`) or a partner account that is not ACTIVE. Never used for cross-partner access, which returns 404.
- `429`: Rate limit exceeded: 300 requests per 60 seconds per API key, shared across all `/api/v1` endpoints (requests without a `Bearer` key fall back to 60 per 60 seconds per client IP, and a per-address flood ceiling of 1200 per 60 seconds also applies). Honor `Retry-After`.
- `500`: Server error. Retry with exponential backoff.

---

[API](https://skmtc.dev/easy2257/apis/easy2257-partner-api.md) · [All operations](https://skmtc.dev/easy2257/apis/easy2257-partner-api/llms.txt) · [OpenAPI document](https://skmtc.dev/easy2257/apis/easy2257-partner-api/revisions/f880026c1f04?raw)