---
title: "Get Pools"
method: GET
path: "/api/pool"
tags: ["Pool API"]
---

# Get Pools

`GET /api/pool`

## Request

- The document declares no server URL.
- Auth: none declared

Returns information regarding pools to users.

If all_pools is set to true, all pools' information will be returned in API response.
Otherwise, only information from pools that the user has access to will be returned
in the response.

## Query parameters

- `all_pools` boolean
- `pools` string[], nullable

## Response `200`

Successful Response

- MinimalPoolConfig: Stores minimal pool configs.
  - `pools` object

## Other responses

- `422`: Validation Error

## Changes

- **2026-08-03** `b9d312a13f5d`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-04-08** `a8157dc3279d`: 3 breaking, 10 info
  - response property `pools/additionalProperties/default_platform` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `pools/additionalProperties/download_type` response's property type changed from `string` to no type for status `200`
  - the `pools/additionalProperties/resources` response's property type changed from no type to `object` for status `200`
  - `query` request parameter `pools` list-of-types was widened by adding types `null`
  - …9 more
- **2026-03-31** `639e39b0d1eb`: 1 breaking, 1 info
  - the response's body type changed from `string` to `object` for status `200`
  - added the optional property `pools` to the response with the `200` status

[Operation history](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/changes/api/pool/get.md)

---

[API](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api.md) - [All operations](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nvidia/apis/nvidia-corporation-osmo-api/revisions/845585a71dbb?raw)