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

# List reward codes



## OpenAPI

````yaml get /v1/rewards/{id}/codes
openapi: 3.1.0
info:
  title: One of None API
  version: 1.0.0
  description: >-
    The One of None API manages product collections, registrations, short URLs,
    team operations, and rewards used by storefront integrations including
    Shopify discounts and redemption flows.
servers:
  - url: https://api.oneofnone.io
security:
  - ApiKeyAuth: []
paths:
  /v1/rewards/{id}/codes:
    get:
      summary: List reward codes
      parameters:
        - schema:
            type: string
            format: uuid
          required: true
          name: id
          in: path
        - schema:
            type: string
            enum:
              - available
              - reserved
              - redeemed
              - expired
              - revoked
          required: false
          name: status
          in: query
        - schema:
            type: number
            minimum: 1
            maximum: 1000
          required: false
          name: limit
          in: query
        - schema:
            type: number
          required: false
          name: offset
          in: query
        - schema:
            type: string
            enum:
              - asc
              - desc
          required: false
          name: order
          in: query
        - schema:
            type: string
          required: false
          name: order_by
          in: query
        - schema:
            type: boolean
          required: false
          name: include_count
          in: query
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RewardCodesListResponse'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GenericErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    RewardCodesListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/RewardCode'
        pagination:
          type: object
          properties: {}
          additionalProperties: {}
      required:
        - data
        - pagination
    GenericErrorResponse:
      type: object
      properties:
        message:
          type: string
        code:
          type: string
        details:
          type: object
          additionalProperties: {}
      required:
        - message
        - code
      additionalProperties: {}
    RewardCode:
      type:
        - object
        - 'null'
      properties:
        id:
          type: string
          format: uuid
        rewardId:
          type: string
          format: uuid
        code:
          type: string
        status:
          type: string
          enum:
            - available
            - reserved
            - redeemed
            - expired
            - revoked
        reservedFor:
          type:
            - string
            - 'null'
        redeemedBy:
          type:
            - string
            - 'null'
        redeemedAt:
          type:
            - string
            - 'null'
        orderId:
          type:
            - string
            - 'null'
        externalOrderId:
          type:
            - string
            - 'null'
        createdAt:
          type: string
        expiresAt:
          type:
            - string
            - 'null'
        updatedAt:
          type:
            - string
            - 'null'
        externalIds:
          type: object
          properties:
            shopify:
              $ref: '#/components/schemas/RewardCodeExternalIdEntry'
            stripe:
              $ref: '#/components/schemas/RewardCodeExternalIdEntry'
          additionalProperties: {}
      required:
        - id
        - rewardId
        - code
        - status
        - reservedFor
        - redeemedBy
        - redeemedAt
        - orderId
        - externalOrderId
        - createdAt
        - expiresAt
        - updatedAt
        - externalIds
      additionalProperties: false
    RewardCodeExternalIdEntry:
      type: object
      properties:
        discountId:
          type: string
        codeId:
          type:
            - string
            - 'null'
        syncedAt:
          type: string
        syncStatus:
          type: string
          enum:
            - synced
            - pending
            - error
        error:
          type:
            - string
            - 'null'
      required:
        - discountId
        - codeId
        - syncedAt
        - syncStatus
        - error
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````