---
title: "Request a free API key verification link"
method: POST
path: "/api/v1/keys"
tags: ["Auth"]
---

# Request a free API key verification link

`POST /api/v1/keys`

## Request

- Base URL: `https://worldcastr.com`
- URL: `https://worldcastr.com/api/v1/keys`
- Auth: none required

Starts email verification for a free API key. The key is shown once only after the email link is confirmed.

## Request body

- object
  - `email` string, email, required
  - `attribution` object
    - `utm_source` string
    - `utm_medium` string
    - `utm_campaign` string
    - `landing_url` string
    - `referrer` string

## Response `200`

Verification request accepted

- object
  - `email` string, email, required
  - `verification_required` true, required
  - `verification_sent` boolean, required
  - `expires_at` string, date-time, required

## Other responses

- `400`: Invalid request
- `500`: API key verification request failed
- `502`: API key verification request failed
- `503`: API key verification request failed

---

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