# Use Reward

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v3/{loyalty_club_slug}/members/me/rewards-program/rewards/{id}/use:
    post:
      summary: Use Reward
      deprecated: false
      description: Uses (activates) one of usable rewards purchased by member.
      tags:
        - API Reference/Public API/Rewards/Rewards
      parameters:
        - name: loyalty_club_slug
          in: path
          description: ''
          required: true
          example: infinity-mall
          schema:
            type: string
        - name: id
          in: path
          description: ''
          required: true
          example: 1
          schema:
            type: integer
        - name: Content-Type
          in: header
          description: '[Details](doc-341635)'
          required: true
          example: application/json
          schema:
            type: string
            default: application/json
            const: application/json
        - name: X-User-Agent
          in: header
          description: Arbitrary identifier of your client. [Details](doc-341635)
          required: true
          example: '{{X_USER_AGENT}}'
          schema:
            type: string
            default: '{{X_USER_AGENT}}'
        - name: X-Product-Name
          in: header
          description: API Product for API context. [Details](doc-341635)
          required: true
          example: '{{PRODUCT_NAME}}'
          schema:
            type: string
            default: '{{PRODUCT_NAME}}'
        - name: X-Loyalty-Club-Slug
          in: header
          description: LoyaltyClub for API context. [Details](doc-342138)
          required: false
          example: '{{LOYALTY_CLUB_SLUG}}'
          schema:
            type: string
            default: '{{LOYALTY_CLUB_SLUG}}'
        - name: X-Customer
          in: header
          description: Customer for API context.  [Details](doc-342139)
          required: false
          example: '{{CUSTOMER_ID}}'
          schema:
            type: string
            default: '{{CUSTOMER_ID}}'
        - name: Authorization
          in: header
          description: '[Member](doc-342129) or [User](doc-342130) Authorization.'
          required: false
          example: Bearer {{_OAUTH_TOKEN}}
          schema:
            type: string
            default: Bearer {{_OAUTH_TOKEN}}
        - name: X-Client-Authorization
          in: header
          description: '[Token](doc-342128) Authorization.'
          example: '{{API_TOKEN}}'
          schema:
            type: string
            default: '{{API_TOKEN}}'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  usage:
                    type: object
                    properties:
                      left:
                        type: integer
                        description: how many times reward could be used
                        minimum: 0
                      usable:
                        type: boolean
                      active_until:
                        anyOf:
                          - &ref_0
                            $ref: '#/components/schemas/date_time'
                          - type: 'null'
                    x-apidog-orders:
                      - left
                      - usable
                      - active_until
                    required:
                      - left
                      - usable
                      - active_until
                    description: See [Reward Usage](api-3510879#usage)
                    x-apidog-ignore-properties: []
                x-apidog-orders:
                  - usage
                required:
                  - usage
                x-apidog-ignore-properties: []
              example:
                usage:
                  left: 5
                  usable: false
                  active_until: '2028-11-09T16:25:58.099512Z'
          headers: {}
          x-apidog-name: Success
        '404':
          description: ''
          content:
            application/json:
              schema:
                title: ''
                type: object
                properties:
                  error:
                    type: string
                    examples:
                      - Record not found
                x-apidog-orders:
                  - error
                required:
                  - error
                x-apidog-ignore-properties: []
          headers: {}
          x-apidog-name: ''
        '422':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - Already active
                      - Not granted
                      - User limit exceeded
                    x-apidog-enum:
                      - value: Already active
                        name: ''
                        description: The reward has been just used
                      - value: Not granted
                        name: ''
                        description: The reward has not been purchased by member
                      - value: User limit exceeded
                        name: ''
                        description: >-
                          There are no more rewards available to purchase for
                          the member
                required:
                  - error
                x-apidog-orders:
                  - error
                x-apidog-ignore-properties: []
              examples:
                '2':
                  summary: Example 1
                  value:
                    error: User limit exceeded
                '3':
                  summary: Example 2
                  value:
                    error: Not granted
                '4':
                  summary: Example 3
                  value:
                    error: Already active
          headers: {}
          x-apidog-name: ''
        '467':
          description: ''
          content:
            application/json:
              schema:
                title: ''
                type: object
                properties:
                  error:
                    type: string
                    const: Member is banned!
                  banned_until: *ref_0
                x-apidog-orders:
                  - error
                  - banned_until
                required:
                  - error
                  - banned_until
                x-apidog-ignore-properties: []
              example:
                error: Member is banned!
                banned_until: '2022-11-09T16:25:58.099512Z'
          headers: {}
          x-apidog-name: ''
      security: []
      x-apidog-folder: API Reference/Public API/Rewards/Rewards
      x-apidog-status: released
      x-run-in-apidog: https://app.eu.apidog.com/web/project/346351/apis/api-3510881-run
components:
  schemas:
    date_time:
      type: string
      format: date-time
      examples:
        - '2022-11-09T16:25:58.099512Z'
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://api.mpc.dev.placewise.com
    description: Staging
security: []

```