# Read a pending agent authorization, for the consent screen

> Read a pending agent authorization, for the consent screen: CustomDomain™ API reference in the agents group. Covers parameters, request body and responses.

Source: https://docs.customdomain.ai/docs/api-reference/agents/getAgentConsentRequest

## `GET https://api.customdomain.ai/v1/agent/consent-request/{id}`

What the console shows a signed in owner before they approve an agent: the client's name, where its authorization code would go (`redirect_host`), whether that destination is a known assistant's own (`verified`, `verified_as`) or the person's own computer (`local`), whether the name imitates a brand it does not belong to (`imitates`; such a request cannot be approved), how the client identified itself, and the scopes asked for. The unguessable request id is the capability: it needs no other credential and reveals only this.

### Authentication

None.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes |  |

### Responses

| Status | Description |
| --- | --- |
| `200` | The pending request |
| `404` | Error envelope: {code, title, details}. |
| `503` | Error envelope: {code, title, details}. |

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `client_id` | string | yes |  |
| `client_name` | string | yes |  |
| `redirect_uri` | string | yes | Where the authorization code goes if the person approves. |
| `scopes` | array of `domains:read`, `domains:connect`, `domains:disconnect`, `domains:purchase`, `stats:read`, `audit:read`, `app:read`, `app:write`, `tokens:mint`, `member:read`, `member:manage`, `keys:manage` | yes | What the agent asked for. |
| `state` | string | no | The agent's own state value, echoed back to it. |
| `redirect_host` | string | yes | The host of `redirect_uri`. The client cannot choose it freely the way it chooses its name, so show it. |
| `verified` | boolean | yes | True when `redirect_host` is a known assistant's own callback host or a loopback address, and the name imitates no brand. |
| `verified_as` | string | no | The known assistant `redirect_host` belongs to. |
| `local` | boolean | yes | True when the code goes to a program on the approver's own computer (a loopback redirect). |
| `imitates` | string | no | The brand the name claims without owning the redirect host. Such a request cannot be approved. |
| `registration` | `dynamic`, `metadata_document` | yes | How the client identified itself, by RFC 7591 registration or by a Client ID Metadata Document. |
| `registered_at` | string | no | When a dynamically registered client registered. |
| `client_id_host` | string | no | The host that publishes a metadata document client's document. |

The full specification is served at `GET https://api.customdomain.ai/v1/openapi.json`.
