> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get agent

> Retrieve full detail for one registered agent, including account flags

`GET /api/v2/storefront/agents/{agentId}`

Returns detailed information about a single registered agent: capabilities, authentication type, master and per-account authorization flags, account counts, and — for owner `PENDING` OAUTH agents without tokens — an `oauth` block with the authorization URL. Use it to decide which authorization flow an agent needs before you call it.

## Request

```bash theme={null}
curl "https://api.interchange.io/api/v2/storefront/agents/agt_premium_ctv" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"
```

## Parameters

| Param     | Type   | Required | Notes                             |
| --------- | ------ | -------- | --------------------------------- |
| `agentId` | string | Yes      | Agent identifier (path parameter) |

## Response

```json theme={null}
{
  "agentId": "agt_premium_ctv",
  "type": "SALES",
  "name": "Premium CTV — Direct",
  "description": "Direct CTV inventory for premium sports and news.",
  "endpointUrl": "https://agent.premium-ctv.example.com/mcp",
  "protocol": "MCP",
  "authenticationType": "OAUTH",
  "requiresOperatorAuth": true,
  "status": "ACTIVE",
  "relationship": "SELF",
  "customerId": 4821,
  "reportingType": "WEBHOOK",
  "reportingPollingCadence": null,
  "customerAccountCount": 2,
  "hasCustomerAccount": true,
  "hasMasterAccount": false,
  "customerAccount": {
    "id": "acct_55",
    "accountIdentifier": "acme-brand-account",
    "status": "ACTIVE",
    "registeredBy": "seller@acme-media.example.com",
    "createdAt": "2026-05-02T09:00:00Z"
  },
  "createdAt": "2026-05-01T12:00:00Z",
  "updatedAt": "2026-05-02T09:00:00Z",
  "oauth": null
}
```

`authenticationType` is `API_KEY`, `NO_AUTH`, `JWT`, `OAUTH`, or `BASIC_AUTH`. When it is `OAUTH` and the agent is an owner `PENDING` agent without tokens, the `oauth` block carries an `authorizationUrl`; otherwise start a flow with [Start agent OAuth](/v2/storefront/agents/tasks/start-agent-oauth).

## Errors

* `404 NOT_FOUND` — no agent with that `agentId` is visible to the authenticated seller.

See [Errors](/v2/reference/errors) for the full error contract.

## Related

<CardGroup cols={2}>
  <Card title="Agent tasks" href="/v2/storefront/agents/tasks" icon="list-check">
    All agent operations
  </Card>

  <Card title="List agents" href="/v2/storefront/agents/tasks/list-agents" icon="list">
    Find the agent ID
  </Card>

  <Card title="Start agent OAuth" href="/v2/storefront/agents/tasks/start-agent-oauth" icon="key">
    Agent-level token flow
  </Card>

  <Card title="Start account OAuth" href="/v2/storefront/agents/tasks/start-account-oauth" icon="user-lock">
    Per-account token flow
  </Card>
</CardGroup>