---
title: "List IP groups"
method: POST
path: "/api/v3/ip-groups"
tags: ["IPGroup"]
---

# List IP groups

`POST /api/v3/ip-groups`

Retrieve an IPGroup

## Request body

- GithubComStoryprotocolProtocolApiApiInternalModelsProtocolv2IPGroupsRequestBody
  - `options` GithubComStoryprotocolProtocolApiApiInternalModelsProtocolv2IPGroupsQueryOptions
    - `ipAssetIds` string[]
    - `orderBy` string
    - `orderDirection` string
    - `pagination` object
      - `after` string
      - `before` string
      - `limit` integer
    - `tokenContractIds` string[]
    - `tokenIds` string[]
    - `where` object
      - `groupId` string

## Response `200`

OK

- GithubComStoryprotocolProtocolApiApiInternalModelsProtocolv2IPGroupsResponse
  - `data` GithubComStoryprotocolProtocolApiApiInternalModelsProtocolv2IPGroup[]
    - `group_id` string
    - `ip_count` integer
  - `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)