---
title: "Get labels"
method: GET
path: "/api/v1/concepts/{concept_id}/labels"
tags: ["concept"]
---

# Get labels

`GET /api/v1/concepts/{concept_id}/labels`

Get all labels for a concept

## Path parameters

- `concept_id` string, uuid4, required

## Query parameters

- `offset` integer
- `limit` integer
- `labels_to_include` ConceptLabelEnum[]

## Headers

- `Authorization` string, required

## Response `200`

Paginated labels for the concept

- PagedConceptLabels — A paginated list of labels
  - `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` ConceptLabel[], required — The paginated data
    - `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
    - `labelId` string, uuid4, required — The label id
    - `label` 'positive' | 'negative', required — Concept label values
    - `image` Image — An image asset response
      - `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
      - `coactiveImageId` string, uuid4, required — The coactive image id
      - `path` string — The original path of the image
      - `id` string, nullable — The user provided image id
      - `metadata` ImageMetadata — The user provided metadata for the image
    - `keyframe` Keyframe — A keyframe asset response
      - `coactiveImageId` string, uuid4, required — The coactive image id
      - `video` Video, required — A video asset response
        - `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
        - `path` string, nullable — The original path of the video
        - `coactiveVideoId` string, uuid4, required — The coactive video id
        - `metadata` VideoMetadata — Metadata associated with a video shot.
          - `data` object
      - `shot` AppSharedV1SchemaShot, required — Metadata about a video shot
        - `shotId` string, uuid4, required — The unique shot id
        - `startTimeMs` integer, required — The start time in milliseconds from the beginning of the video
        - `endTimeMs` integer, required — The end time in milliseconds from the beginning of the video
      - `audioSegment` AppSharedV1SchemaAudioSegment — Metadata about a video audio segment
        - `startTimeMs` integer, required — The start time in milliseconds of the beginning of the audio clip
        - `endTimeMs` integer, required — The end time in milliseconds of the end of the audio clip
        - `speechToTextTranscription` string, required — The text transcription of the audio clip
      - `timestamp` integer, nullable — The timestamp of the keyframe in the video in milliseconds

## Other responses

- `404` — Concept not found
- `422` — Validation Error

---

[API](https://skmtc.net/coactive/apis/api-reference.md) · [All operations](https://skmtc.net/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/coactive/api-reference/versions/c24e3835accc/schema)