---
title: "Get publisher crawl request status"
method: GET
path: "/api/registry/crawl-request/{crawlRequestId}"
tags: ["Agent Discovery"]
---

# Get publisher crawl request status

`GET /api/registry/crawl-request/{crawlRequestId}`

## Request

- Base URL: `https://agenticadvertising.org`
- URL: `https://agenticadvertising.org/api/registry/crawl-request/{crawlRequestId}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://agenticadvertising.org/authorize`
    - Token URL: `https://agenticadvertising.org/token`

Return the durable lifecycle for a publisher recrawl. Requesters may read their own requests; registry administrators may read any request.

## Path parameters

- `crawlRequestId` string, uuid, required

## Response `200`

Durable crawl request lifecycle

- object
  - `crawl_request_id` string, uuid, required
  - `domain` string, required
  - `status` 'queued' | 'running' | 'deferred' | 'retrying' | 'completed' | 'invalid' | 'failed', required
  - `attempts` integer, required
  - `max_attempts` integer, required
  - `requested_at` string, date-time, required
  - `started_at` string, date-time, nullable, required
  - `last_attempted_at` string, date-time, nullable, required
  - `completed_at` string, date-time, nullable, required
  - `next_attempt_at` string, date-time, nullable, required
  - `last_error_code` string, nullable, required

## Other responses

- `400`: Invalid crawl request ID
- `401`: Authentication required
- `404`: Crawl request not found
- `503`: Crawl status or administrator authorization is temporarily unavailable

## Changes

- **2026-09-17** `cb485604bda3`: 4 breaking, 1 info
  - the response's body type changed from `object` to no type for status `503`
  - removed the required property `code` from the response with the `503` status
  - removed the required property `error` from the response with the `503` status
  - removed the required property `retry_after` from the response with the `503` status
  - …1 more
- **2026-08-10** `26dede3c65c1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/changes/api/registry/crawl-request/:crawlRequestId/get.md)

---

[API](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api.md) - [All operations](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/revisions/d8f6af89f253?raw)