---
title: "Create an API key as an AI agent"
method: POST
path: "/agent/signup/"
tags: ["Agent Account"]
---

# Create an API key as an AI agent

`POST /agent/signup/`

## Request

- Base URL: `https://api.financialreports.eu`
- URL: `https://api.financialreports.eu/agent/signup/`
- Auth: none declared

Creates an account for the given email and returns an API key once. No email is sent. The key works for a small Level-1 read-only sandbox; beyond it data calls return 402 until the owner confirms (POST /agent/owner-confirmation) or a card is added (POST /agent/checkout-link). If the address cannot be used, the 409 carries a claim_token and user_code: the owner of an existing account may be emailed to approve it, and POST /agent/key-claim then returns their key.

## Request body

- AgentSignupRequest
  - `email` string, email, required: The account owner's real email address.
  - `agent_name` string, required: 1-64 chars: letters, digits, space, _ or -.

## Response `201`

Key created (shown once).

- object

## Other responses

- `400`: invalid_email / email_not_allowed / invalid_agent_name.
- `409`: account_exists, with claim_token / user_code / claim_endpoint.
- `429`: rate_limited.
- `503`: signup_paused / signup_unavailable.

---

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