---
title: "Get Signup History"
method: GET
path: "/admin/signup_history"
tags: ["accepts-api-key"]
---

# Get Signup History

`GET /admin/signup_history`

## Request

- Base URL: `https://api.tellers.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tellers.ai/admin/signup_history`
- Auth: none declared

Report whether an email ever had an account, and its grant status. Admin only.

The history table is keyed by a SHA-256 hash of the email — it has to
outlive the accounts it describes, so it stores no personal data. Look-ups
therefore go through this route, which hashes the email you supply.

## Query parameters

- `email` string, required: Email to look up

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- SignupHistoryResponse
  - `known` boolean, required: True if this email ever had an account on Tellers
  - `free_grant_already_given` boolean, required: True if this email already received the signup grant; a new account for it gets no free tokens
  - `free_trial_used` boolean, required: True if this email already used the subscription free trial. Always false for now: nothing writes it yet, because the backend never grants the trial — Stripe does, off the price.
  - `signup_count` integer, required: Number of accounts created so far
  - `deleted_count` integer, required: Number of accounts deleted so far
  - `first_signup_at` string, date-time, nullable
  - `last_signup_at` string, date-time, nullable
  - `free_grant_granted_at` string, date-time, nullable
  - `last_deleted_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

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