---
title: "Claim a free API key and receive it in the response"
method: POST
path: "/v1/keys/instant"
---

# Claim a free API key and receive it in the response

`POST /v1/keys/instant`

## Request

- Base URL: `https://random-profiles.com`
- URL: `https://random-profiles.com/v1/keys/instant`
- Auth: none declared

Creates (or re-returns) a free API key, delivering it directly in the response body. Still sends a receipt email. Designed for non-interactive clients (MCP servers, CLIs, CI) that can't read email. Disposable email domains are rejected. Rate limited per IP.

## Request body

- object
  - `email` string, email, required

## Response `200`

Key returned in body and emailed as a receipt

- object
  - `key` string, required
  - `status` 'created' | 'existing', required
  - `email` string, email

## Other responses

- `400`: Invalid or disposable email
- `429`: Rate limited

---

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