---
url: /orchestration/reference/operations/ListServices.md
description: 'GET /v2/services — List services, optionally filtered'
---

> Documentation index: https://developer.civitai.com/llms.txt — every page on this site has a markdown version at its URL + `.md`.

# List services, optionally filtered

`GET https://orchestration.civitai.com/v2/services`

Operation `ListServices` · Services · Civitai Orchestration API, generated from the published OpenAPI spec ([v2-consumers.json](https://developer.civitai.com/openapi/v2-consumers.json)); the interactive HTML page is this URL without `.md`.

## Authentication

The spec marks this operation anonymous (`security: []`): no token is needed.

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `category` | query | string | no | Restrict to a category (image, video, chat, audio, text, 3d, model, utility). |
| `prefix` | query | string | no | Restrict to a subtree of the id, e.g. "image/flux2". |
| `tags` | query | array of string | no | Only services carrying all of these tags. |
| `query` | query | string | no | Free-text over id, name, description and tags. |
| `status` | query | `ServiceStatus` (one of `unknown`, `available`, `degraded`, `unavailable`) | no | Only services currently in this state. |
| `window` | query | string | no | Window the metrics and status are computed over: 1h, 24h or 7d. (default `"24h"`) |
| `limit` | query | integer (int32) | no | Maximum number of services to return. (default `50`) |
| `offset` | query | integer (int32) | no | Number of services to skip. (default `0`) |

## Responses

### 200 OK

Content type: `application/json`.

Schema `PaginatedResponseOfServiceResponse`.

| Field | Type | Required | Description |
|---|---|---|---|
| `items` | array of `ServiceResponse` | yes |  |
| `totalCount` | integer (int32) | yes |  |
| `limit` | integer (int32) | yes |  |
| `offset` | integer (int32) | yes |  |

### 400 Bad Request

Content type: `application/json`.

Schema `ProblemDetails`.

| Field | Type | Required | Description |
|---|---|---|---|
| `type` | string, nullable | no |  |
| `title` | string, nullable | no |  |
| `status` | integer (int32), nullable | no |  |
| `detail` | string, nullable | no |  |
| `instance` | string, nullable | no |  |