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

> Search and retrieve skills used for project targeting. Use the returned IDs when configuring skill-based targeting on a project. **Note:** Skill IDs differ between staging and production.

# Retrieve skill list



## OpenAPI

````yaml get /v1/skills
openapi: 3.0.0
info:
  title: Partner API
  description: Public API for partner integrations
  version: '1.0'
  contact: {}
servers:
  - url: https://api-staging.respondent.io
security: []
tags: []
paths:
  /v1/skills:
    get:
      tags:
        - skills
      summary: Retrieve skill list
      operationId: SkillsController_search
      parameters:
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
        - name: x-api-secret
          in: header
          required: true
          schema:
            type: string
        - name: page
          required: false
          in: query
          schema:
            type: number
            default: 1
        - name: pageSize
          required: false
          in: query
          schema:
            type: number
            default: 50
        - name: includeCount
          required: false
          in: query
          schema:
            type: boolean
            default: false
        - name: query
          required: false
          in: query
          description: 'Character Limit: min 3 and max 100'
          schema:
            type: string
        - name: validated
          required: false
          in: query
          schema:
            type: boolean
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SkillsPaginatedDto'
components:
  schemas:
    SkillsPaginatedDto:
      type: object
      properties:
        totalResults:
          type: number
          description: >-
            The total number of results possible, which is only provided in the
            response when `includeCount` is passed as `true` within a request.
        page:
          type: number
          default: 1
        pageSize:
          type: number
          default: 50
        results:
          type: array
          items:
            $ref: '#/components/schemas/Skill'
      required:
        - page
        - pageSize
        - results
    Skill:
      type: object
      properties:
        createdAt:
          type: string
        updatedAt:
          type: string
        name:
          type: string
        slug:
          type: string
        validated:
          type: boolean
          default: false
        type:
          type: string
          default: skill
        count:
          type: number
          default: 0
        id:
          type: string
      required:
        - createdAt
        - name
        - slug
        - validated
        - type
        - id

````