---
title: "List trainings"
method: GET
path: "/talent-training/api/v1/trainings"
tags: ["Trainings"]
---

# List trainings

`GET /talent-training/api/v1/trainings`

Retrieve a paginated list of trainings.

## Query parameters

- `search` string
- `providerIds` integer[]
- `categoryIds` integer[]
- `id` integer[]
- `fields.root` 'count'
- `page` integer
- `limit` integer

## Response `200`

OK

- object
  - `count` integer, nullable — Total number of items across all pages. You need to include ?fields.root=count to your request to retrieve this.
  - `prev` string, nullable — Cursor to the previous page. You need to include ?fields.root=prev in order to retrieve this.
  - `next` string, nullable — Cursor to the next page. You need to include ?fields.root=next in order to retrieve this.
  - `items` V1Training[]
    - `id` integer — Unique identifier of the training
    - `type` 'External' | 'Internal' — External trainings are managed by external organizations, whereas internal trainings are managed by employees within your company.
    - `state` 'Ready' | 'Archived' — - `ready`: the training object is published and as such can be referenced by a new realized-training. - `archived`: the training object is archived and as such should no longer be referenced in new realized-trainings.
    - `title` string, required — Name of the training (maximum length = 250 characters)
    - `subtitle` string, required — Short summary of the training (maximum length = 1000 characters)
    - `description` string, required — Detailed description of the training (maximum length = 6000 characters)
    - `provider` object
      - `id` integer — Unique identifier of the provider
      - `name` string — Name of the provider
      - `websiteHref` string, uri — Remote URL to a page presenting the provider
    - `level` 'Beginner' | 'Middle' | 'Expert', required — - `Beginner` : For finding out about the subject - `Middle` : For deepening your knowledge - `Expert` : For becoming a specialist
    - `isCertifying` boolean, required — Is it an accredited training?
    - `isMandatory` boolean, required — Is the training mandatory according to legal requirements?
    - `category` object
      - `id` integer — Unique identifier of the category
      - `name` string — Name of the category
      - `t9n` object — Translations object
        - `name` T9n, nullable
          - `De` string, nullable — German (Germany)
          - `En` string, nullable — English (United States of America)
          - `Es` string, nullable — Spanish (Spain)
          - `Fr` string, nullable — French (France)
          - `It` string, nullable — Italian (Italy)
          - `Nl` string, nullable — Dutch (Belgium)
          - `Pt` string, nullable — Portuguese (Portugal)

---

[API](https://skmtc.net/luccasoftware/apis/lucca-expenses.md) · [All operations](https://skmtc.net/luccasoftware/apis/lucca-expenses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/luccasoftware/lucca-expenses/revisions/110f9897756c/schema)