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

# Retrieve reward

> Retrieves a single reward by its uuid.



## OpenAPI

````yaml /api-reference/openapi.yaml get /gifts/{uuid}
openapi: 3.1.0
info:
  title: Giftbit API
  version: v1
  description: >
    Giftbit's REST API lets you automatically order rewards and send them to
    your

    recipients. Delivery can be handled either by links that integrate into
    another

    system's workflow, or by emails sent through the Giftbit system.


    Authenticate every request with a bearer token in the `Authorization`
    header.

    Only an HTTP `200` means success; all non-`200` responses share a common
    error body.
  contact:
    name: Giftbit Support
    email: testbed@giftbit.com
    url: https://www.giftbit.com/api-documentation
servers:
  - url: https://api-testbed.giftbit.com/papi/v1
    description: Testbed
  - url: https://api.giftbit.com/papi/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Ping
    description: Test your authentication and check the health of the Giftbit API.
  - name: Brands
    description: List reward brands and retrieve extended information about a single brand.
  - name: Regions
    description: List the regions used to filter brands and request Full Catalog rewards.
  - name: Email Orders
    description: Order one or more rewards delivered to recipients by Giftbit email.
  - name: Shortlink Orders
    description: Order branded shortlink rewards that include a customized landing page.
  - name: Direct Link Orders
    description: >-
      Order minimally branded direct link rewards returned immediately in the
      response.
  - name: Embedded Rewards
    description: >-
      Order a single in-app reward for immediate delivery in your app or
      website.
  - name: Funds
    description: Retrieve your account balance and top it up with a credit card payment.
  - name: Rewards
    description: List, retrieve, resend, and cancel individual rewards.
paths:
  /gifts/{uuid}:
    get:
      tags:
        - Rewards
      summary: Retrieve reward
      description: Retrieves a single reward by its uuid.
      operationId: retrieve-reward
      parameters:
        - name: uuid
          in: path
          required: true
          description: >-
            The uuid of the reward. Not to be mistaken for the uuid or id of the
            order.
          schema:
            type: string
      responses:
        '200':
          description: The reward has been retrieved.
          content:
            application/json:
              schema:
                type: object
                properties:
                  gift:
                    $ref: '#/components/schemas/Gift'
                  info:
                    $ref: '#/components/schemas/Info'
                  status:
                    type: integer
              example:
                gift:
                  uuid: d30be501ed2546e580c5c9eaf56633d9
                  campaign_uuid: 8f5835dfb637413793c5d55f8ea95e23
                  delivery_status: DELIVERED
                  status: SENT_AND_REDEEMABLE
                  redelivery_count: 0
                  campaign_id: may11
                  price_in_cents: 500
                  brand_code: itunesus
                  created_date: '2016-05-11 12:18:25'
                  delivery_date: '2016-05-11 12:18:32'
                info:
                  code: INFO_GIFTS
                  name: Gift information retrieved
                  message: Returned gifts matching your search parameters.
                status: 200
components:
  schemas:
    Gift:
      type: object
      description: A single reward.
      properties:
        uuid:
          type: string
        campaign_uuid:
          type: string
        delivery_status:
          type: string
          enum:
            - UNSENT
            - DELIVERED
            - LINKCREATED
            - UNDELIVERABLE
            - TEMPORARILY_UNDELIVERABLE
            - UNSUBSCRIBED
            - COMPLAINT
        status:
          type: string
          enum:
            - SENT_AND_REDEEMABLE
            - REDEEMED
            - TO_CHARITY
            - GIVER_CANCELLED
            - EXPIRED
        management_dashboard_link:
          type: string
        redelivery_count:
          type: integer
        campaign_id:
          type: string
        price_in_cents:
          type: integer
        brand_code:
          type: string
        marketplacegift_id:
          type: string
          description: Deprecated. Refer to brand_code.
        recipient_name:
          type: string
        recipient_email:
          type: string
        created_date:
          type: string
        delivery_date:
          type: string
    Info:
      type: object
      description: Status information returned on successful requests.
      properties:
        code:
          type: string
          description: An enum-style status code for the request.
        name:
          type: string
          description: Human-readable status name.
        message:
          type: string
          description: Request-context-specific message.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Send your API token prefixed by `Bearer ` in the `Authorization` header.

````