---
title: "Read account and first-bid prerequisites. Supply optional day, ad_id and amount_cents for a concrete readiness snapshot, including browser steps and continuation actions."
method: GET
path: "/v1/agent/me"
---

# Read account and first-bid prerequisites. Supply optional day, ad_id and amount_cents for a concrete readiness snapshot, including browser steps and continuation actions.

`GET /v1/agent/me`

## Request

- Base URL: `https://api.nowyourlink.com`
- URL: `https://api.nowyourlink.com/v1/agent/me`
- Auth: OAuth 2 (authorization code, authorization URL `https://api.nowyourlink.com/oauth/authorize`, token URL `https://api.nowyourlink.com/oauth/token`, scopes: `account:read`)

Read account and first-bid prerequisites. Supply optional day, ad_id and amount_cents for a concrete readiness snapshot, including browser steps and continuation actions.

## Query parameters

- `day` string, date: Settled auction date in UTC, YYYY-MM-DD.
- `ad_id` string
- `amount_cents` integer

## Response `200`

Account summary. Never includes e-mail, VAT id or payment details.

- object
  - `user_id` string, required
  - `company_name` string, nullable, required
  - `country` string, nullable, required
  - `tier` string, nullable, required
  - `eligibility` object, required
    - `can_bid` boolean, required
    - `reasons` string[], required
    - `action_url` string, uri-reference: Browser path or hosted identity verification URL.
  - `first_bid` object, required
    - `checked_at` string, date-time, required
    - `status` 'ready' | 'blocked' | 'unknown', required
    - `requirements` object[], required
      - `id` string, required
      - `status` 'satisfied' | 'blocked' | 'unknown', required
      - `code` string, required
      - `detail` string, required
      - `action` object
    - `next_action` object, required
      - `actor` 'agent' | 'user' | 'wait', required
      - `label` string, required
      - `url` string, uri-reference, required
      - `tool` string
      - `arguments` object
      - `required_scopes` string[]
      - `required_inputs` string[]
    - `recovery` object, required: Read list_my_bids for the original day before reusing the original request and idempotency key after an uncertain write. Acceptance is not winning or delivery.
  - `mandate` object, nullable, required
    - `max_bid_cents` integer, required
    - `daily_cap_cents` integer, required
    - `valid_until` string, date-time, required
  - `scopes` string[], required

## Other responses

- `401`: The bearer token is missing, expired or invalid. A missing Authorization header returns an empty body.
- `403`: This grant lacks the scope the operation requires.
- `405`: The path exists but does not accept this method (agent.method-not-allowed).
- `429`: This grant's 120-per-minute token bucket is empty. Wait Retry-After seconds before retrying.

---

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