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

# List

> Returns all campaigns from the system that the user has access to

<Note>
  The `type` parameter returned for each campaign determines which results
  endpoint to use.

  If `type` is `SESSION_COMPLETION`, use the [Session Evaluation Results](/api-reference/endpoint/session-results) endpoint.

  If `type` is `ROLE_SUBMISSION`, use the [Role Evaluation Results](/api-reference/endpoint/campaigns-results) endpoint.
</Note>


## OpenAPI

````yaml GET /v1/campaigns
openapi: 3.1.0
info:
  title: HiredNow External API
  description: Customer-facing API for retrieving campaign evaluation results.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.external.hirednow.ai
security:
  - bearerAuth: []
paths:
  /v1/campaigns:
    get:
      tags:
        - Campaigns
      summary: Get all campaigns
      description: Returns all campaigns from the system that the user has access to
      operationId: getCampaigns
      parameters: []
      responses:
        '200':
          description: Campaigns response
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          description: Unique identifier for the campaign
                          type: string
                          format: uuid
                        name:
                          description: Internal name of the campaign
                          type: string
                        created_at:
                          description: Timestamp when the campaign was created
                          type: string
                          format: date-time
                        display_name:
                          description: Human-readable display name for the campaign
                          type: string
                        type:
                          description: Type of campaign
                          type: string
                          enum:
                            - SESSION_COMPLETION
                            - ROLE_SUBMISSION
              example:
                data:
                  - id: 3f7a9c2e-5d8b-4e1a-9c6f-8b2d4e7a1c9f
                    name: summer-sales-2024
                    created_at: '2024-06-09T01:17:24.137Z'
                    display_name: Summer Sales Campaign 2024
                    type: SESSION_COMPLETION
                  - id: 8e4b1f7c-3a9d-4c2e-8f5b-1d7a9c4e6b8f
                    name: holiday-promotion-2024
                    created_at: '2024-06-09T01:17:21.088Z'
                    display_name: Holiday Promotion 2024
                    type: ROLE_SUBMISSION
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                error:
                  message: Unauthorized
                  status_code: 401
                  request_id: 3a6e9741-268b-41a7-b924-5fa7019e6f26
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          required:
            - message
            - status_code
            - request_id
          properties:
            message:
              type: string
              description: Human-readable error message
            status_code:
              type: integer
              format: int32
              description: HTTP status code
            request_id:
              type: string
              format: uuid
              description: Unique identifier for the request, useful for debugging
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````