---
title: "Read an account before claiming it"
method: GET
path: "/v1/agents/claim"
tags: ["Agents"]
---

# Read an account before claiming it

`GET /v1/agents/claim`

## Request

- Base URL: `https://api.nvoke.run`
- URL: `https://api.nvoke.run/v1/agents/claim`
- Auth: HTTP bearer

Called by the claim page on nvoke.run: who created the account and whether it is claimed. Unlike every other signed-in request, it does not claim the account.

## Response `200`

OK

- object
  - `account` object, required
    - `createdBy` 'human' | 'agent', required
    - `agentName` string, nullable, required
    - `claimedAt` string, date-time, nullable, required

## Other responses

- `4XX`: `unauthorized`: No valid token. Send `Authorization: Bearer <key>`.

---

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