Auth API reference

Auth API · Consumer-Agent-Access

get/{app_slug}/v1/agent-access/authorizations/{handle}Auth

Read 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*string

The app slug.

handle*string

The `request` query value (`pcar_…`).

Response · 200 The request.

status*object

Only `pending` can be decided.

expires_at*string · date-time

The request expires here (10 minutes after /authorize).

client*object
client_id*string

The 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*string

The 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 · uri

The homepage the client declared, if any (https only).

verified*boolean

True 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*string

Who publishes a verified client; null otherwise.

Example: "Anthropic"

metadata_host*string

The host serving the metadata document (`metadata_document` clients only). Show it for an unverified one.

Example: "claude.ai"

redirect*object
host*string

Where the browser goes after a decision.

Example: "localhost"

loopback*boolean

A loopback redirect: the agent runs on the same computer as the browser.

resource*string

The resource the agent wants a token for.

Example: "https://mcp.example.com/mcp"

requested_scopes*array

The requested scopes with their catalogue descriptions.

Example

Request

GET https://api.auth.productcraft.co/{app_slug}/v1/agent-access/authorizations/{handle}
Authorization: Bearer YOUR_TOKEN

Response

{
  "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"
    }
  ]
}