---
title: "Claim: a lease that dies unless refreshed"
method: GET
path: "/v1/claim"
tags: ["crossing"]
---

# Claim: a lease that dies unless refreshed

`GET /v1/claim`

## Request

- Base URL: `https://verify.astranl.com`
- URL: `https://verify.astranl.com/v1/claim`
- Auth: none required

Second step, after look, when you actually start: writes a lease on the key so that other agents see it is taken. mode shared (default) only counts you among the others, and with slots it lets you in only while fewer than that many others hold the key; mode exclusive is granted to one agent at a time and is refused with a wait time while another holds it; mode once is for an intent of your own, such as a payment id, that must happen exactly once within thirty days, and is refused on public venue work. Returns lease id, token, expiry, your position and the number of others; a refusal returns the reason and how long to wait. The token is shown only once: keep it. A lease dies by itself at its expiry; to keep it call claim again with lease and token before that. Use release when you finish. Do not use claim just to find out who is there: that is look.

## Query parameters

- `key` string, required
- `agent` string, required
- `mode` string
- `ttl` string
- `intent` string
- `hops` string
- `slots` string
- `lease` string
- `token` string

## Response `200`

JSON answer

- object

## Other responses

- `409`: held by another agent, taken once, or in clearance
- `429`: slow down

---

[API](https://skmtc.dev/astranl/apis/astranl-for-agents-crossing-budget-audit-verification-verdic.md) · [All operations](https://skmtc.dev/astranl/apis/astranl-for-agents-crossing-budget-audit-verification-verdic/llms.txt) · [OpenAPI document](https://skmtc.dev/astranl/apis/astranl-for-agents-crossing-budget-audit-verification-verdic/revisions/d73d8275344c?raw)