---
title: "List the authenticated account's agent relationships"
method: GET
path: "/api/v2/accounts/agent-relationships"
tags: ["Account Endpoints"]
---

# List the authenticated account's agent relationships

`GET /api/v2/accounts/agent-relationships`

## Request

- Base URL: `https://api.opensea.io`
- URL: `https://api.opensea.io/api/v2/accounts/agent-relationships`
- Auth: API key in header `x-api-key` and OpenID Connect (`https://auth.opensea.io/.well-known/openid-configuration`, scopes: `read:wallets`)
- TypeScript: <https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/accounts/agent-relationships/get.ts> (a function with typed inputs; its response is checked against the schema)

Includes proposals still awaiting either party. Pending relationships appear here only; they are never shown on a public profile. Truncated to the 100 most recent confirmed relationships and the 50 most recent live proposals, bounded separately so unanswered proposals cannot displace confirmed relationships. No total is returned. Confirming or revoking names the counterparty's account id, which this listing is the source of.

## Response `200`

OK

- AgentRelationshipListResponse
  - `relationships` AgentRelationshipResponse[], required
    - `agent_account_id` string, required
    - `awaiting_confirmation_from` string, nullable
    - `confirmed_at` number, double, nullable: Unix timestamp in seconds, including fractional seconds
    - `created_at` number, double, required: Unix timestamp in seconds, including fractional seconds
    - `owner_account_id` string, required
    - `status` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

## Changes

- **2026-11-03** `2c7935d84f90`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/opensea/apis/opensea-api/changes/api/v2/accounts/agent-relationships/get.md)

---

[API](https://skmtc.dev/opensea/apis/opensea-api.md) - [All operations](https://skmtc.dev/opensea/apis/opensea-api/llms.txt) - [OpenAPI document](https://skmtc.dev/opensea/apis/opensea-api/revisions/2c7935d84f90?raw)