---
title: "Collect an existing account's key once its owner approves"
method: POST
path: "/agent/key-claim/"
tags: ["Agent Account"]
---

# Collect an existing account's key once its owner approves

`POST /agent/key-claim/`

## Request

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

``POST /agent/key-claim``: collect the key an existing account's owner approved
after a signup 409 (#5375). Unauthenticated: the signed claim token is the
credential.

## Request body

- AgentKeyClaimRequest
  - `claim_token` string, required: claim_token from the signup 409.

## Response `200`

Key (shown once).

- object

## Other responses

- `202`: pending: poll again after Retry-After.
- `400`: invalid_request / invalid_claim_token.
- `410`: claim_expired / claim_used / claim_refused.
- `503`: claim_unavailable: nothing changed, poll again after Retry-After.

---

[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)