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

# Get promo codes

> With this endpoint you can list all promo codes. 
 <Tip>**HTTP Request** <br/>`GET https://api.firstpromoter.com/api/v2/company/promo_codes`</Tip>



## OpenAPI

````yaml openapi-v2-promocodes get /promo_codes
openapi: 3.0.1
info:
  title: FirstPromoter PromoCodes API
  version: '1.0'
  description: API for managing promo codes in FirstPromoter
servers:
  - url: https://api.firstpromoter.com/api/v2/company
security:
  - BearerAuth: []
paths:
  /promo_codes:
    get:
      tags:
        - Promo Codes
      summary: Get promo codes
      description: |-
        With this endpoint you can list all promo codes. 
         <Tip>**HTTP Request** <br/>`GET https://api.firstpromoter.com/api/v2/company/promo_codes`</Tip>
      operationId: getPromoCodes
      parameters:
        - $ref: '#/components/parameters/AccountId'
        - name: promoter_campaign_id
          in: query
          description: Filters promo codes by promoter campaign id
          required: false
          schema:
            type: integer
      responses:
        '200':
          description: List of promo codes
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/PromoCode'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    AccountId:
      name: Account-ID
      in: header
      required: true
      description: >-
        Account id. You can find your Account ID on Your FirstPromoter
        Dashboard. Navigate to Settings → Integrations
      schema:
        type: string
  schemas:
    PromoCode:
      type: object
      properties:
        id:
          type: integer
          description: ID of the promo code entry
        code:
          type: string
          description: Code of the promo code
        reward:
          type: object
          properties:
            id:
              type: integer
              description: ID of the reward
            name:
              type: string
              description: Name of the reward
          description: Reward
        ext_id:
          type: string
        description:
          type: string
          description: Description of the promo code
        company_id:
          type: integer
        promoter_campaign_id:
          type: integer
          description: ID of the promoter campaign
        metadata:
          type: object
          description: Metadata of the promo code
        details:
          type: object
          description: Details of the promo code
        archived_at:
          type: string
          format: date-time
    Error:
      type: object
      properties:
        message:
          type: string
        code:
          type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key passed as a Bearer token in the Authorization header. You can
        find your API Key on Your FirstPromoter Dashboard. Navigate to Settings
        → Integrations section → Manage API Keys

````