---
title: "Get public agent ownership relationships for a profile"
method: GET
path: "/api/v2/accounts/{address_or_username}/agent-relationships"
tags: ["Account Endpoints"]
---

# Get public agent ownership relationships for a profile

`GET /api/v2/accounts/{address_or_username}/agent-relationships`

## Request

- Base URL: `https://api.opensea.io`
- URL: `https://api.opensea.io/api/v2/accounts/{address_or_username}/agent-relationships`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/accounts/:address_or_username/agent-relationships/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the account confirmed to own this one as its agent, and the accounts it is the confirmed owner of. Only relationships both accounts confirmed appear; a proposal one side has not accepted is visible to the two parties alone. Ownership is a declaration and not an authorization, and is self-reported rather than verified by OpenSea. Standard API-key quotas and an additional 30-per-hour per-profile limit apply.

## Path parameters

- `address_or_username` string, required

## Response `200`

OK

- AgentProfileRelationshipsResponse: Public agent ownership relationships for a profile
  - `agent_owner` AgentProfileSummaryResponse: Compact public profile summary for an agent relationship
    - `address` string, required
    - `display_name` string, nullable
    - `is_verified` boolean, required
    - `profile_image_url` string, nullable
    - `username` string, nullable
  - `agents` AgentProfileSummaryResponse[], required: The accounts this one is the confirmed owner of, newest relationship first. Empty when there are none.
    - `address` string, required
    - `display_name` string, nullable
    - `is_verified` boolean, required
    - `profile_image_url` string, nullable
    - `username` string, nullable

## 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/:address_or_username/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)