Account Endpoints

Get profile shelves

Changed on Nov 3, 2026

Get the shelves for a public wallet address.

get/api/v2/profile/shelves

Request

Base URL
https://api.opensea.io
Auth
- API key in header x-api-key
- or API key in header x-api-key and OpenID Connect (https://auth.opensea.io/.well-known/openid-configuration)
TypeScript
https://skmtc.dev/opensea/apis/opensea-api/docs/api/v2/profile/shelves/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

addressstring required

Wallet address to retrieve shelves for

Response

Shelves retrieved successfully

account_addressstring nullable

descriptionstring nullable

display_orderinteger required

iconstring nullable

idstring required

shelf_item_metadataobject required

single_item_shelf_sidestring nullable

titlestring required

viewstring nullable

Changes

Nov 3, 20262c7935d84f90 Revision changes
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property /// became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- info
  added the media type */* for the response with the status
- info
  added the media type */* for the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history