---
title: "List concepts"
method: GET
path: "/api/v1/concepts"
tags: ["concept"]
---

# List concepts

`GET /api/v1/concepts`

Get paginated concepts, optionally filtered by datasets

## Query parameters

- `datasets` string[]
- `offset` integer
- `limit` integer

## Headers

- `Authorization` string, required

## Response `200`

All concepts

- PagedConcepts — A response containing paged data
  - `meta` PagedMetaResponse, required — Metadata about the paginated response
    - `page` PagedPageDetailsResponse, required — Pagination metadata
      - `currentPage` integer, required — Current page number
      - `lastPage` integer, nullable — Max page number based on limit and total number of items
      - `limit` integer, required — Number of items to return
      - `offset` integer, required — Starting index to return
      - `total` integer, nullable — Total number of items
    - `links` PagedLinksResponse, required — Metadata for retrieving paginated data
      - `prev` string, nullable — Link to previous page
      - `next` string, nullable — Link to next page
      - `first` string, nullable — Link to first page
      - `last` string, nullable — Link to last page
    - `sort` SortItem[], required — Ordered list of fields to sort on, order of list determines priority
      - `direction` 'asc' | 'desc', required — Possible sort orders asc: ascending desc: descending
      - `field` string, required — Which field to sort on
  - `data` Concept[], required — The paginated concepts
    - `createdUserId` string, required — The user that created the resource
    - `createdDt` string, date-time, required — The created datetime of the resource
    - `updatedUserId` string, required — The user that last updated the resource
    - `updatedDt` string, date-time, required — The datetime the resource was last updated
    - `name` string, required — The name of the concept
    - `description` string, nullable — A description for the concept
    - `threshold` number, double, nullable — Threshold above which classification is positive
    - `regularization` number, double, nullable — How strongly the model adapts to the training labels. Regularization strength. Lower value means the model fits more heavily to the training data
    - `conceptId` string, uuid4, required — The unique identifier for the concept
    - `datasetId` string, uuid4, required — The unique identifier for the dataset

## Other responses

- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)