/{app_slug}/v1/agent-access/authorizations/{handle}AuthRead a pending agent authorization (consent screen)
Your consent page calls this with the `request` handle /authorize sent the browser to it with. The first signed-in end user to read a request is bound to it; anyone else gets 404. Shows who is asking (`client.name` is self-declared: say it is unverified), where the browser returns and which scopes were requested. Requests live 10 minutes.
Path parameters
app_slug*stringThe app slug.
handle*stringThe `request` query value (`pcar_…`).
Response · 200 The request.
status*objectOnly `pending` can be decided.
expires_at*string · date-timeThe request expires here (10 minutes after /authorize).
client*objectclient_id*stringThe client id: `pcac_…` for a self-registered (DCR) client, or the https URL of its Client ID Metadata Document.
Example: "https://claude.ai/oauth/claude-code-client-metadata"
name*stringThe name to show. For a verified client, the name Auth pins for its publisher; otherwise the name the client declared itself (bidi and invisible characters removed): show it as unverified, and isolate it (`<bdi>`) when you place it inside a sentence.
Example: "Claude Code"
uri*string · uriThe homepage the client declared, if any (https only).
verified*booleanTrue when the client's metadata document is one Auth vouches for (e.g. Claude Code's at claude.ai). Show it as verified, without an unverified warning. False for every self-registered client and every other metadata document.
kind*object`self_registered`: RFC 7591 dynamic registration. `metadata_document`: the client_id is a Client ID Metadata Document URL Auth fetched and checked.
publisher*stringWho publishes a verified client; null otherwise.
Example: "Anthropic"
metadata_host*stringThe host serving the metadata document (`metadata_document` clients only). Show it for an unverified one.
Example: "claude.ai"
redirect*objecthost*stringWhere the browser goes after a decision.
Example: "localhost"
loopback*booleanA loopback redirect: the agent runs on the same computer as the browser.
resource*stringThe resource the agent wants a token for.
Example: "https://mcp.example.com/mcp"
requested_scopes*arrayThe requested scopes with their catalogue descriptions.
Example
Request
GET https://api.auth.productcraft.co/{app_slug}/v1/agent-access/authorizations/{handle}
Authorization: Bearer YOUR_TOKENResponse
{
"status": {},
"expires_at": "2026-01-01T00:00:00.000Z",
"client": {
"client_id": "https://claude.ai/oauth/claude-code-client-metadata",
"name": "Claude Code",
"uri": "string",
"verified": false,
"kind": {},
"publisher": "Anthropic",
"metadata_host": "claude.ai"
},
"redirect": {
"host": "localhost",
"loopback": false
},
"resource": "https://mcp.example.com/mcp",
"requested_scopes": [
{
"name": "disputes:read",
"description": "Read disputes, transactions and evidence"
}
]
}