> ## Documentation Index
> Fetch the complete documentation index at: https://developers.projectcor.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get project labels

> Returns project label categories and available labels for the company (same shape as grouped categories for the project entity type), plus the labels currently assigned to the given project in **`selected`**.

Use **`GET /categories/labels-model?model=project`** for a simpler category tree without per-project selection. To **assign or remove** labels on a project, use **`PUT /projects/{project_id}`** with a `labels` array.



## OpenAPI

````yaml /api-reference/openapi.json get /projects/{project_id}/labels
openapi: 3.1.0
info:
  title: COR API
  description: >-
    The COR API lets you integrate with projectcor.com applications using simple
    HTTP methods, in either XML or JSON formats, making this an ideal API for
    developing integrations with other softwares, external clients or mobile
    applications
  version: 1.0.0
servers:
  - url: https://api.projectcor.com/v1
    description: Production server
security:
  - bearerAuth: []
paths:
  /projects/{project_id}/labels:
    get:
      tags:
        - Projects
        - Labels
      summary: Get project labels
      description: >-
        Returns project label categories and available labels for the company
        (same shape as grouped categories for the project entity type), plus the
        labels currently assigned to the given project in **`selected`**.


        Use **`GET /categories/labels-model?model=project`** for a simpler
        category tree without per-project selection. To **assign or remove**
        labels on a project, use **`PUT /projects/{project_id}`** with a
        `labels` array.
      parameters:
        - name: project_id
          in: path
          required: true
          schema:
            type: integer
          description: Project ID. Must belong to the authenticated user's company.
        - name: page
          in: query
          required: false
          schema:
            type:
              - integer
              - boolean
            default: false
          description: >-
            Pagination page number. Set to false (the default) to disable
            pagination.
        - name: perPage
          in: query
          required: false
          schema:
            type: integer
            default: 20
          description: Page size when pagination is enabled.
        - name: order
          in: query
          required: false
          schema:
            type: string
            default: '{}'
          description: >-
            JSON object as a string (must be valid JSON) for sort criteria
            passed to the label query.
        - name: filters
          in: query
          required: false
          schema:
            type: string
            default: '{}'
          description: >-
            JSON object as a string (must be valid JSON) with filter criteria
            for the grouped labels query (e.g. `ids`, `name`, `limit`).
      responses:
        '200':
          description: Grouped project labels and labels assigned to this project
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProjectLabelsResponse'
        '400':
          description: >-
            Validation error (e.g. invalid JSON in `order` or `filters`, or
            project not found / not in company)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CORCustomError'
components:
  schemas:
    ProjectLabelsResponse:
      type: object
      required:
        - labels
      properties:
        labels:
          type: array
          description: >-
            Categories with their labels, scoped to the project label entity
            type.
          items:
            $ref: '#/components/schemas/Category'
        selected:
          type: array
          description: >-
            Labels currently assigned to the project (present when a valid
            `project_id` is provided).
          items:
            $ref: '#/components/schemas/Label'
    CORCustomError:
      type: object
      properties:
        status:
          type: integer
        name:
          type: string
        code:
          type: string
        message:
          type: string
    Category:
      type: object
      properties:
        id:
          type: integer
        name:
          type: string
        labels:
          type: array
          items:
            $ref: '#/components/schemas/Label'
    Label:
      type: object
      properties:
        id:
          type: integer
        hex:
          type: string
          description: Hex color code
        hsl:
          type: string
          nullable: true
        rgb:
          type: string
          nullable: true
        lang:
          type: string
        name:
          type: string
        color_id:
          type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````