---
title: "List IPAssets"
method: POST
path: "/api/v3/assets"
tags: ["IPAssets"]
---

# List IPAssets

`POST /api/v3/assets`

Retrieve a paginated, filtered list of IPAssets

## Request body

- GithubComStoryprotocolProtocolApiApiInternalModelsProtocolv2IpAssetRequestBody
  - `options` GithubComStoryprotocolProtocolApiApiInternalModelsProtocolv2IpAssetQueryOptions
    - `ipAssetIds` string[]
    - `orderBy` string
    - `orderDirection` string
    - `pagination` object
      - `after` string
      - `before` string
      - `limit` integer
    - `tokenContractIds` string[]
    - `tokenIds` string[]
    - `where` object
      - `blockNumber` string
      - `blockNumberGte` string
      - `blockNumberLte` string
      - `id` string
      - `ipId` string
      - `tokenContract` string
      - `tokenId` string

## Response `200`

OK

- GithubComStoryprotocolProtocolApiApiInternalModelsProtocolv3IPAssetsResponse
  - `data` GithubComStoryprotocolProtocolApiApiInternalModelsProtocolv3IPAsset[]
    - `ancestorCount` integer
    - `blockNumber` string
    - `blockTimestamp` string
    - `childrenCount` integer
    - `descendantCount` integer
    - `id` string
    - `ipId` string
    - `isGroup` boolean
    - `latestArbitrationPolicy` string
    - `nftMetadata` GithubComStoryprotocolProtocolApiApiInternalModelsProtocolv3NftMetadata
      - `chainId` string
      - `imageUrl` string
      - `name` string
      - `tokenContract` string
      - `tokenId` string
      - `tokenUri` string
    - `parentCount` integer
    - `rootCount` integer
    - `rootIpIds` string[]
    - `transactionHash` string
  - `hasNextPage` boolean
  - `hasPreviousPage` boolean
  - `next` string
  - `prev` string

---

[API](https://skmtc.net/storyapis/apis/story-protocol-api-reference.md) · [All operations](https://skmtc.net/storyapis/apis/story-protocol-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/storyapis/story-protocol-api-reference/revisions/6cb84b9791cd/schema)