# List services

Source: https://developers.weerom.com/docs/reference/services/listServices

```http
GET https://api.weerom.com/v1/services
```

Every service, in the order the shop shows them.

**Keys:** every kind of key works here.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `active` | query | boolean | no | Only active ones, or only inactive ones. |

## Responses

### 200

The request worked.

| Field | Type | Description |
| --- | --- | --- |
| `data` | array of object |  |
| `data[].active` | boolean | False once the shop stopped offering it. |
| `data[].created_at` | string (date-time) | When the service was added. |
| `data[].currency` | string | ISO 4217 code of every amount on this object. |
| `data[].id` | string (uuid) | The service's id. |
| `data[].minutes` | integer | How long it takes. |
| `data[].name` | string | The name in the shop's own language. |
| `data[].name_translations` | object | The name in each language. An empty string means not translated. |
| `data[].name_translations.de` | string |  |
| `data[].name_translations.en` | string |  |
| `data[].name_translations.fr` | string |  |
| `data[].name_translations.nl` | string |  |
| `data[].name_translations.pt` | string |  |
| `data[].object` | `service` |  |
| `data[].price_cents` | integer | The list price, VAT included. |
| `data[].updated_at` | string (date-time) | When the service last changed. |
| `has_more` | boolean | Whether another page follows this one. |
| `next_cursor` | string or null | Send as `cursor` for the next page. Null on the last. |
| `object` | `list` |  |

Example:

```json
{
  "data": [
    {
      "active": true,
      "created_at": "2026-03-02T08:15:00.000Z",
      "currency": "EUR",
      "id": "c2a41f6e-8d3b-4e97-b5a0-1f7c9e2d4a68",
      "minutes": 45,
      "name": "Knippen en baard",
      "name_translations": {
        "de": "",
        "en": "Cut and beard",
        "fr": "Coupe et barbe",
        "nl": "Knippen en baard",
        "pt": ""
      },
      "object": "service",
      "price_cents": 4000,
      "updated_at": "2026-09-14T16:40:00.000Z"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "object": "list"
}
```

### 400

A parameter or a field is missing or malformed.

### 401

No key, an unknown key or a revoked key.

### 403

The shop's plan does not include the API, or this kind of key may not call this.

### 429

Too many requests. Retry-After says when.

Every error answers `{ "error": { "code", "message", "param", "request_id" } }`. `param` is only on some 400 answers. See [Errors](https://developers.weerom.com/docs/errors).

## Keys

Every kind of key: read key, write key and public key.

## Sort

In the order the shop shows its services, then by `id`. The order is fixed.

## Filters

- `active=true` keeps the services the shop offers. `active=false` keeps the ones it stopped offering. Leave it out for both.

## What it does

- The whole list fits on one page: `has_more` is `false` and `next_cursor` is `null`. The list takes no `limit`, `cursor` or `order`, and sending one answers 400 `invalid_request`.
