---
title: "Start or renew a claim"
method: POST
path: "/agent/identity/claim"
tags: ["agent-auth"]
---

# Start or renew a claim

`POST /agent/identity/claim`

## Request

- Base URL: `https://api.letsship.ai/v1`
- URL: `https://api.letsship.ai/v1/agent/identity/claim`
- Auth: none declared

Binds an anonymous registration to the email of the person the agent acts for and returns a code for that person, or mints a new code for a pending registration whose code expired.

## Request body

- InitiateClaimRequest
  - `claim_token` string, required
  - `email` string, required

## Response `200`

Claim started.

- InitiateClaimResponse
  - `registration_id` string, required
  - `claim_attempt_id` string, required
  - `status` 'initiated', required
  - `expires_at` string, required
  - `claim_attempt` ClaimCeremony, required
    - `user_code` string, required
    - `verification_uri` string, required
    - `expires_in` integer, required
    - `interval` integer, required

## Other responses

- `400`: Invalid request.
- `401`: invalid_claim_token.
- `409`: claimed_or_in_flight.
- `410`: claim_expired.

---

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