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

# Get reward redemption status

> Returns the current state of a pending or completed reward redemption for the authenticated consumer. Supply exactly one of `polling_id` (returned by a prior reward claim call), `reward_name` (the configured reward name), or `partner_event_id` (the originating partner event identifier). Poll this endpoint until the reward reaches a terminal state.



## OpenAPI

````yaml /api-reference/integration-consumer-to-extole.json get /api/v4/me/rewards/status
openapi: 3.0.1
info:
  description: >-
    Consumer-to-Extole integration endpoints: consumer event submission, zone
    rendering, profile management, and SDK-backing operations for browser and
    native app environments.
  title: Integration API - Consumer to Extole
  version: '1.0'
servers:
  - description: Production
    url: https://{brand}.extole.io
    variables:
      brand:
        default: yourcompany
        description: >-
          Your Extole client subdomain (e.g. 'mycompany' for
          mycompany.extole.io)
security:
  - HEADER: []
  - QUERY: []
  - COOKIE: []
tags:
  - name: Authentication
  - name: Content
  - name: Email
  - name: Events
  - name: Persons
  - name: Profile Assets
  - name: Profiles
paths:
  /api/v4/me/rewards/status:
    get:
      tags:
        - Profiles
      summary: Get reward redemption status
      description: >-
        Returns the current state of a pending or completed reward redemption
        for the authenticated consumer. Supply exactly one of `polling_id`
        (returned by a prior reward claim call), `reward_name` (the configured
        reward name), or `partner_event_id` (the originating partner event
        identifier). Poll this endpoint until the reward reaches a terminal
        state.
      operationId: getMyRewardStatus
      parameters:
        - description: Polling identifier returned by the reward claim call.
          in: query
          name: polling_id
          schema:
            type: string
        - description: The configured name of the reward to look up.
          in: query
          name: reward_name
          schema:
            type: string
        - description: The partner-supplied event identifier that originated the reward.
          in: query
          name: partner_event_id
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PollingRewardResponse'
          description: Reward redemption status.
        '400':
          content:
            application/json:
              examples:
                invalid_reward_filter:
                  $ref: '#/components/examples/invalid_reward_filter'
                invalid_reward_id:
                  $ref: '#/components/examples/invalid_reward_id'
              schema:
                $ref: '#/components/schemas/RestExceptionResponse'
          description: >-
            The reward query is invalid: `invalid_reward_id` if the supplied
            `polling_id` does not resolve to a reward, or
            `invalid_reward_filter` if none of `polling_id`, `reward_name`, or
            `partner_event_id` was supplied.
        '401':
          content:
            application/json:
              examples:
                method_unauthorized:
                  $ref: '#/components/examples/method_unauthorized'
              schema:
                $ref: '#/components/schemas/RestExceptionResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              examples:
                access_denied:
                  $ref: '#/components/examples/access_denied'
                expired_access_token:
                  $ref: '#/components/examples/expired_access_token'
                invalid_access_token:
                  $ref: '#/components/examples/invalid_access_token'
                jwt_authentication_error:
                  $ref: '#/components/examples/jwt_authentication_error'
                method_unauthorized:
                  $ref: '#/components/examples/method_unauthorized'
                missing_access_token:
                  $ref: '#/components/examples/missing_access_token'
              schema:
                $ref: '#/components/schemas/RestExceptionResponse'
          description: Forbidden
        '415':
          content:
            application/json:
              examples:
                unsupported_media_type:
                  $ref: '#/components/examples/unsupported_media_type'
              schema:
                $ref: '#/components/schemas/RestExceptionResponse'
          description: Unsupported Media Type
        '429':
          content:
            application/json:
              examples:
                too_many_requests:
                  $ref: '#/components/examples/too_many_requests'
              schema:
                $ref: '#/components/schemas/RestExceptionResponse'
          description: Too Many Requests
components:
  schemas:
    PollingRewardResponse:
      properties:
        quality_results:
          description: Quality evaluation results associated with this reward redemption.
          items:
            $ref: '#/components/schemas/QualityResults'
          type: array
        reward:
          $ref: '#/components/schemas/RewardResponse'
        status:
          description: >-
            Current processing status of the reward redemption (`PENDING`,
            `SUCCEEDED`, or `FAILED`).
          enum:
            - FAILED
            - PENDING
            - SUCCEEDED
          type: string
      required:
        - quality_results
        - reward
        - status
      type: object
    RestExceptionResponse:
      description: Represents the API error response
      properties:
        code:
          description: Specific error code for this error type, documented per endpoint
          type: string
        http_status_code:
          description: >-
            HTTP status code that was returned with this error, useful if client
            get response code
          format: int32
          type: integer
        message:
          description: User readable English description of the error
          type: string
        parameters:
          additionalProperties:
            description: >-
              Attributes related to the error, varies be error code, documented
              per endpoint
            type: object
          description: >-
            Attributes related to the error, varies be error code, documented
            per endpoint
          type: object
        unique_id:
          description: >-
            Unique id associated with this error, useful for discussions with
            Extole
          type: string
      required:
        - code
        - http_status_code
        - message
        - parameters
        - unique_id
      type: object
    QualityResults:
      properties:
        quality_rule_results:
          items:
            $ref: '#/components/schemas/QualityRuleResult'
          type: array
        score:
          enum:
            - ERROR
            - HIGH
            - LOW
          type: string
      type: object
    RewardResponse:
      properties:
        action_id:
          description: Extole action id associated with this reward.
          type: string
        campaign_id:
          description: Extole campaign id associated with this reward.
          type: string
        cause_event_id:
          description: Id of the direct cause event that triggered this reward.
          type: string
        container:
          description: Campaign container the reward belongs to.
          type: string
        created_at:
          $ref: '#/components/schemas/ZonedDateTime'
        data:
          additionalProperties:
            description: Named data parameters attached to this reward.
            type: string
          description: Named data parameters attached to this reward.
          type: object
        email:
          description: Email address of the reward recipient. Null if not available.
          nullable: true
          type: string
        expires_at:
          $ref: '#/components/schemas/ZonedDateTime'
        face_value:
          description: Monetary or point face value of the reward.
          type: number
        face_value_type:
          description: Unit type of the face value (e.g. `CASH`, `POINTS`, `PERCENT`).
          enum:
            - AUD
            - BRL
            - CAD
            - CNY
            - EUR
            - GBP
            - HKD
            - INR
            - JPY
            - KRW
            - MONTH
            - MXN
            - NZD
            - PERCENT_OFF
            - POINTS
            - TRY
            - TWD
            - USD
          type: string
        journey_key:
          $ref: '#/components/schemas/JourneyKey'
        journey_name:
          description: Name of the journey associated with this reward.
          type: string
        partner_reward_id:
          description: >-
            Partner-assigned identifier for this reward. Null if not yet
            assigned.
          nullable: true
          type: string
        partner_reward_key_type:
          description: Type of key used to identify the reward at the partner's system.
          enum:
            - COUPON
            - ID
            - LINK
          type: string
        partner_reward_supplier_id:
          description: >-
            Partner-assigned identifier for the reward supplier. Null if not
            provided.
          nullable: true
          type: string
        partner_user_id:
          description: Partner's identifier for the person. Null if not provided.
          nullable: true
          type: string
        person_id:
          description: Extole person id of the reward recipient.
          type: string
        reward_id:
          description: Extole-assigned unique identifier for this reward.
          type: string
        reward_supplier_id:
          description: Extole reward supplier id that issued this reward.
          type: string
        root_event_id:
          description: >-
            Id of the root event that initiated the chain leading to this
            reward.
          type: string
        sandbox:
          description: Sandbox identifier for this reward.
          type: string
        state:
          description: Current lifecycle state of the reward.
          enum:
            - CANCELED
            - EARNED
            - FAILED
            - FULFILLED
            - REDEEMED
            - REVOKED
            - SENT
          type: string
      required:
        - action_id
        - campaign_id
        - cause_event_id
        - container
        - created_at
        - data
        - email
        - expires_at
        - face_value
        - face_value_type
        - journey_key
        - journey_name
        - partner_reward_id
        - partner_reward_key_type
        - partner_reward_supplier_id
        - partner_user_id
        - person_id
        - reward_id
        - reward_supplier_id
        - root_event_id
        - sandbox
        - state
      type: object
    QualityRuleResult:
      properties:
        rule_name:
          type: string
        score:
          enum:
            - ERROR
            - HIGH
            - LOW
          type: string
      type: object
    ZonedDateTime:
      description: >-
        [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) or
        [RFC 9557](https://datatracker.ietf.org/doc/html/rfc9557#section-4)
        date-time with a numeric [UTC
        offset](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) and
        an optional [IANA
        time-zone](https://datatracker.ietf.org/doc/html/rfc9557#section-4)
        suffix in square brackets. Precision up to milliseconds.
      example: '2025-10-24T02:00:00-07:00'
      pattern: >-
        ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?(Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])(\[[^\]]+\])?$
      type: string
    JourneyKey:
      properties:
        name:
          type: string
        value:
          type: string
      type: object
  examples:
    invalid_reward_filter:
      summary: invalid_reward_filter
      value:
        code: invalid_reward_filter
        http_status_code: 400
        message: >-
          Invalid reward filter, one of: polling_id, reward_name or
          partner_event_id are required
        parameters: {}
        unique_id: 00000000-0000-0000-0000-000000000000
    invalid_reward_id:
      summary: invalid_reward_id
      value:
        code: invalid_reward_id
        http_status_code: 400
        message: Invalid reward id. Reward not found.
        parameters: {}
        unique_id: 00000000-0000-0000-0000-000000000000
    method_unauthorized:
      summary: method_unauthorized
      value:
        code: method_unauthorized
        http_status_code: 401
        message: Unauthorized access to this endpoint
        parameters: {}
        unique_id: 00000000-0000-0000-0000-000000000000
    access_denied:
      summary: access_denied
      value:
        code: access_denied
        http_status_code: 403
        message: >-
          The access_token provided is not permitted to access the specified
          resource.
        parameters: {}
        unique_id: 00000000-0000-0000-0000-000000000000
    expired_access_token:
      summary: expired_access_token
      value:
        code: expired_access_token
        http_status_code: 403
        message: The access_token provided with this request has expired.
        parameters: {}
        unique_id: 00000000-0000-0000-0000-000000000000
    invalid_access_token:
      summary: invalid_access_token
      value:
        code: invalid_access_token
        http_status_code: 403
        message: The access_token provided with this request is invalid.
        parameters: {}
        unique_id: 00000000-0000-0000-0000-000000000000
    jwt_authentication_error:
      summary: jwt_authentication_error
      value:
        code: jwt_authentication_error
        http_status_code: 403
        message: The jwt authentication failed.
        parameters: {}
        unique_id: 00000000-0000-0000-0000-000000000000
    missing_access_token:
      summary: missing_access_token
      value:
        code: missing_access_token
        http_status_code: 403
        message: No access_token was provided with this request.
        parameters: {}
        unique_id: 00000000-0000-0000-0000-000000000000
    unsupported_media_type:
      summary: unsupported_media_type
      value:
        code: unsupported_media_type
        http_status_code: 415
        message: Request had an unsupported or no media type
        parameters: {}
        unique_id: 00000000-0000-0000-0000-000000000000
    too_many_requests:
      summary: too_many_requests
      value:
        code: too_many_requests
        http_status_code: 429
        message: >-
          The server is unable to process your request at the moment, please
          retry later.
        parameters: {}
        unique_id: 00000000-0000-0000-0000-000000000000
  securitySchemes:
    HEADER:
      in: header
      name: Authorization
      type: apiKey
      x-bearer-format: bearer
    QUERY:
      in: query
      name: access_token
      type: apiKey
    COOKIE:
      in: cookie
      name: extole_token
      type: apiKey

````