find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/brevo-reward-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Loyalty Reward API
  version: 1.0.0
servers:
- url: https://api.brevo.com/v3
  description: https://api.brevo.com/v3
tags:
- name: reward
paths:
  /loyalty/offer/programs/{pid}/code-pools/{cpid}/codes-count:
    get:
      operationId: getCodeCount
      summary: Get code count
      description: Get code count
      tags:
      - reward
      parameters:
      - name: pid
        in: path
        description: Loyalty Program ID
        required: true
        schema:
          type: string
          format: uuid
      - name: cpid
        in: path
        description: Code Pool ID
        required: true
        schema:
          type: string
          format: uuid
      - name: api-key
        in: header
        description: The API key should be passed in the request headers as `api-key` for authentication.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Code count successfully fetched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Reward_getCodeCount_Response_200'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '401':
          description: Request Authentication Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '403':
          description: Cannot Authenticate Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '422':
          description: Validation errors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '500':
          description: Internal error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
  /loyalty/offer/programs/{pid}/vouchers:
    get:
      operationId: getVoucherForAContact
      summary: Get voucher for a contact
      description: Get voucher for a contact
      tags:
      - reward
      parameters:
      - name: pid
        in: path
        description: Loyalty Program ID
        required: true
        schema:
          type: string
          format: uuid
      - name: limit
        in: query
        description: Page size
        required: false
        schema:
          type: integer
          default: 25
      - name: offset
        in: query
        description: Pagination offset
        required: false
        schema:
          type: integer
          default: 0
      - name: sort
        in: query
        description: Sort order
        required: false
        schema:
          $ref: '#/components/schemas/LoyaltyOfferProgramsPidVouchersGetParametersSort'
          default: desc
      - name: sortField
        in: query
        description: Sort field
        required: false
        schema:
          $ref: '#/components/schemas/LoyaltyOfferProgramsPidVouchersGetParametersSortField'
          default: updatedAt
      - name: contactId
        in: query
        description: Contact ID
        required: true
        schema:
          type: integer
      - name: metadata_key_value
        in: query
        description: Metadata value for a Key filter
        required: false
        schema:
          type: string
      - name: rewardId
        in: query
        description: Reward ID
        required: false
        schema:
          type: string
      - name: api-key
        in: header
        description: The API key should be passed in the request headers as `api-key` for authentication.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Voucher list successfully retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Reward_getVoucherForAContact_Response_200'
        '401':
          description: Request Authentication Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '403':
          description: Cannot Authenticate Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '422':
          description: Validation errors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '500':
          description: Internal error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
  /loyalty/offer/programs/{pid}/offers:
    get:
      operationId: getRewardPageApi
      summary: Get Reward Page API
      description: Returns a reward page
      tags:
      - reward
      parameters:
      - name: pid
        in: path
        description: Loyalty Program ID
        required: true
        schema:
          type: string
          format: uuid
      - name: limit
        in: query
        description: Page size
        required: false
        schema:
          type: integer
          default: 25
      - name: offset
        in: query
        description: Pagination offset
        required: false
        schema:
          type: integer
          default: 0
      - name: state
        in: query
        description: State of the reward
        required: false
        schema:
          type: string
          default: all
      - name: version
        in: query
        description: Version
        required: false
        schema:
          $ref: '#/components/schemas/LoyaltyOfferProgramsPidOffersGetParametersVersion'
          default: draft
      - name: api-key
        in: header
        description: The API key should be passed in the request headers as `api-key` for authentication.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Reward list successfully retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Reward_getRewardPageApi_Response_200'
        '401':
          description: Request Authentication Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '403':
          description: Cannot Authenticate Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '422':
          description: Validation errors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '424':
          description: Failed Dependency
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '500':
          description: Internal error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
    post:
      operationId: createReward
      summary: Create a reward
      description: Creates a new reward in the loyalty program.
      tags:
      - reward
      parameters:
      - name: pid
        in: path
        description: Loyalty Program ID
        required: true
        schema:
          type: string
          format: uuid
      - name: api-key
        in: header
        description: The API key should be passed in the request headers as `api-key` for authentication.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Reward successfully created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Reward_createReward_Response_200'
        '401':
          description: Request Authentication Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '403':
          description: Cannot Authenticate Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '422':
          description: Validation errors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '500':
          description: Internal error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: Internal name of the reward
                publicDescription:
                  type: string
                  description: Public facing description of the reward
                publicImage:
                  type: string
                  format: uri
                  description: URL of the public image for the reward
                publicName:
                  type: string
                  description: Public facing name of the reward
              required:
              - name
  /loyalty/offer/programs/{pid}/rewards/{rid}:
    get:
      operationId: getRewardInformation
      summary: Get reward information
      description: Returns reward information.
      tags:
      - reward
      parameters:
      - name: pid
        in: path
        description: Loyalty Program ID
        required: true
        schema:
          type: string
          format: uuid
      - name: rid
        in: path
        description: Reward ID
        required: true
        schema:
          type: string
          format: uuid
      - name: version
        in: query
        description: Version
        required: false
        schema:
          $ref: '#/components/schemas/LoyaltyOfferProgramsPidRewardsRidGetParametersVersion'
          default: draft
      - name: api-key
        in: header
        description: The API key should be passed in the request headers as `api-key` for authentication.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful retrieval of reward data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Reward_getRewardInformation_Response_200'
        '401':
          description: Request Authentication Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '403':
          description: Cannot Authenticate Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '422':
          description: Validation errors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '424':
          description: Failed Dependency
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '500':
          description: Internal error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
  /loyalty/offer/programs/{pid}/rewards/attribute:
    post:
      operationId: createVoucher
      summary: Create a voucher
      description: Create a voucher and attribute it to a specific membership.
      tags:
      - reward
      parameters:
      - name: pid
        in: path
        description: Loyalty Program ID
        required: true
        schema:
          type: string
          format: uuid
      - name: api-key
        in: header
        description: The API key should be passed in the request headers as `api-key` for authentication.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Voucher successfully created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Reward_createVoucher_Response_200'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: string
        '401':
          description: Request Authentication Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '403':
          description: Cannot Authenticate Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '422':
          description: Validation errors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '500':
          description: Internal error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                code:
                  type: string
                  description: Code generated to attribute reward to a contact
                contactId:
                  type: integer
                  format: int64
                  description: Contact to attribute the reward
                expirationDate:
                  type: string
                  description: Reward expiration date
                loyaltySubscriptionId:
                  type: string
                  description: One of contactId or loyaltySubscriptionId is required
                meta:
                  type: object
                  additionalProperties:
                    description: Any type
                  description: Offer meta information (key/value object)
                rewardId:
                  type: string
                  format: uuid
                  description: Reward id
                value:
                  type: number
                  format: double
                  description: Value of the selected reward config
                validFrom:
                  type: string
                  description: Date from which the voucher becomes valid. Accepts RFC 3339 or DD/MM/YYYY HH:MM AM/PM format. Converted to UTC using the organization's timezone.
              required:
              - rewardId
  /loyalty/offer/programs/{pid}/rewards/redeem:
    post:
      operationId: redeemVoucher
      summary: Create redeem voucher request
      description: Creates a request to redeem a voucher.
      tags:
      - reward
      parameters:
      - name: pid
        in: path
        description: Loyalty Program ID
        required: true
        schema:
          type: string
          format: uuid
      - name: api-key
        in: header
        description: The API key should be passed in the request headers as `api-key` for authentication.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Redeem request successfully created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/redeem'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '401':
          description: Request Authentication Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '403':
          description: Cannot Authenticate Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '412':
          description: Precondition Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '417':
          description: Expectation Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '422':
          description: Validation errors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '500':
          description: Internal error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                attributedRewardId:
                  type: string
                  format: uuid
                  description: Unique identifier for the attributed reward
                code:
                  type: string
                  description: Redemption code for the reward
                contactId:
                  type: integer
                  format: int64
                  description: Unique identifier for the contact
                loyaltySubscriptionId:
                  type: string
                  description: Identifier for the loyalty subscription
                meta:
                  type: object
                  additionalProperties:
                    description: Any type
                  description: Additional metadata associated with the redeem request
                order:
                  $ref: '#/components/schemas/LoyaltyOfferProgramsPidRewardsRedeemPostRequestBodyContentApplicationJsonSchemaOrder'
                  description: Order details for the redemption
                rewardId:
                  type: string
                  format: uuid
                  description: Unique identifier for the reward
                ttl:
                  type: integer
                  description: Time to live in seconds for the redemption request
                autoComplete:
                  type: boolean
                  description: Whether the redemption should be automatically completed
  /loyalty/offer/programs/{pid}/rewards/redeem/{tid}/complete:
    post:
      operationId: completeRedeemTransaction
      summary: Complete redeem voucher request
      description: Completes voucher redeem request.
      tags:
      - reward
      parameters:
      - name: pid
        in: path
        description: Loyalty Program ID
        required: true
        schema:
          type: string
          format: uuid
      - name: tid
        in: path
        description: Redeem transaction ID
        required: true
        schema:
          type: string
      - name: api-key
        in: header
        description: The API key should be passed in the request headers as `api-key` for authentication.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Voucher Redeem completed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/redeem'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '401':
          description: Request Authentication Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '403':
          description: Cannot Authenticate Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '412':
          description: Precondition Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '417':
          description: Expectation Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '422':
          description: Validation errors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '500':
          description: Internal error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
  /loyalty/offer/programs/{pid}/rewards/revoke:
    delete:
      operationId: revokeVouchers
      summary: Revoke vouchers
      description: Revoke attributed vouchers.
      tags:
      - reward
      parameters:
      - name: pid
        in: path
        description: Loyalty Program ID
        required: true
        schema:
          type: string
          format: uuid
      - name: attributedRewardIds
        in: query
        description: Reward Attribution IDs (comma seperated)
        required: false
        schema:
          type: string
      - name: api-key
        in: header
        description: The API key should be passed in the request headers as `api-key` for authentication.
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Successful revocation of voucher
          content:
            application/json:
              schema:
                type: object
                properties: {}
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '500':
          description: Internal error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
  /loyalty/offer/programs/{pid}/rewards/validate:
    post:
      operationId: validateReward
      summary: Validate a reward
      description: Validates a reward.
      tags:
      - reward
      parameters:
      - name: pid
        in: path
        description: Loyalty Program ID
        required: true
        schema:
          type: string
          format: uuid
      - name: api-key
        in: header
        description: The API key should be passed in the request headers as `api-key` for authentication.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Reward successfully validated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Reward_validateReward_Response_200'
        '401':
          description: Request Authentication Failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '403':
          description: Cannot Authenticate Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '422':
          description: Validation errors
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '424':
          description: Failed Dependency
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
        '500':
          description: Internal error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorModel'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                attributedRewardId:
                  type: string
                  format: uuid
                  description: Unique identifier for the attributed reward
                code:
                  type: string
                  description: Validation code for the reward
                contactId:
                  type: integer
                  format: int64
                  description: Unique identifier for the contact
                loyaltySubscriptionId:
                  type: string
                  description: Identifier for the loyalty subscription
                pointOfSellId:
                  type: string
                  description: Identifier for the point of sale
                rewardId:
                  type: string
                  format: uuid
                  description: Unique identifier for the reward
components:
  schemas:
    LoyaltyOfferProgramsPidRewardsRedeemPostRequestBodyContentApplicationJsonSchemaOrder:
      type: object
      properties:
        amount:
          type: number
          format: double
          description: Total amount of the order
        billing:
          $ref: '#/components/schemas/LoyaltyOfferProgramsPidRewardsRedeemPostRequestBodyContentApplicationJsonSchemaOrderBilling'
          description: Billing information for the order
        contact_id:
          type: integer
          format: int64
          description: Unique identifier for the contact
        coupons:
          type: array
          items:
            type: string
          description: List of coupon codes applied to the order
        createdAt:
          type: string
          format: date-time
          description: Timestamp when the order was created
        email:
          type: string
          format: email
          description: Email address associated with the order
        id:
          type: string
          description: Unique identifier for the order
        identifiers:
          $ref: '#/components/schemas/LoyaltyOfferProgramsPidRewardsRedeemPostRequestBodyContentApplicationJsonSchemaOrderIdentifiers'
          description: Additional identifiers for the order
        products:
          type: array
          items:
            $ref: '#/components/schemas/LoyaltyOfferProgramsPidRewardsRedeemPostRequestBodyContentApplicationJsonSchemaOrderProductsItems'
          description: List of products in the order
        status:
          type: string
          description: Current status of the order
        storeId:
          type: string
          description: Identifier for the store where the order was placed
        updatedAt:
          type: string
          format: date-time
          description: Timestamp when the order was last updated
      description: Order details for the redemption
      title: LoyaltyOfferProgramsPidRewardsRedeemPostRequestBodyContentApplicationJsonSchemaOrder
    Reward_getCodeCount_Response_200:
      type: object
      properties:
        count:
          type: integer
          format: int64
          description: Number of codes
      title: Reward_getCodeCount_Response_200
    LoyaltyOfferProgramsPidRewardsRidGetResponsesContentApplicationJsonSchemaRewardConfigs:
      type: object
      properties:
        attribution:
          type: string
          description: Attribution config of the reward
        code:
          type: string
          description: Code config of the reward
        value:
          type: string
          description: Value config of the reward
      description: object
      title: LoyaltyOfferProgramsPidRewardsRidGetResponsesContentApplicationJsonSchemaRewardConfigs
    ruleConditionResponse:
      type: object
      properties:
        and:
          type: array
          items:
            $ref: '#/components/schemas/ruleConditionResponse'
          description: Metric to indicate AND between rules
        lhs:
          $ref: '#/components/schemas/valueResponse'
          description: Condition of the rule
        op:
          type: string
          description: Selected operator for the rule
        or:
          type: array
          items:
            $ref: '#/components/schemas/ruleConditionResponse'
          description: Metric to indicate OR between rules
        rhs:
          $ref: '#/components/schemas/valueResponse'
          description: Action of the rule
      title: ruleConditionResponse
    LoyaltyOfferProgramsPidRewardsRidGetResponsesContentApplicationJsonSchemaRuleResultsItemsParametersItems:
      type: object
      properties:
        name:
          type: string
          description: Name of the rule
        value:
          $ref: '#/components/schemas/valueResponse'
          description: Selected value of the parameter to define the rule
      title: LoyaltyOfferProgramsPidRewardsRidGetResponsesContentApplicationJsonSchemaRuleResultsItemsParametersItems
    LoyaltyOfferProgramsPidOffersGetParametersVersion:
      type: string
      enum:
      - active
      - draft
      default: draft
      title: LoyaltyOfferProgramsPidOffersGetParametersVersion
    Reward_getVoucherForAContact_Response_200:
      type: object
      properties:
        contactId:
          type: integer
          format: int64
          description: Contact id associated with the current reward
        contactRewards:
          type: array
          items:
            $ref: '#/components/schemas/LoyaltyOfferProgramsPidVouchersGetResponsesContentApplicationJsonSchemaContactRewardsItems'
          description: List of all the rewards for current contact
        count:
          type: integer
          description: Count of the rewards associated with the current contact
        loyaltyProgramId:
          type: string
          description: Loyalty Program Id for the contact
        loyaltySubscriptionId:
          type: string
          description: Loyalty Subscription Id for the contact
      title: Reward_getVoucherForAContact_Response_200
    Reward_createReward_Response_200:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the reward
        loyaltyProgramId:
          type: string
          format: uuid
          description: Loyalty program to which the reward belongs
        name:
          type: string
          description: Name of the reward
        publicDescription:
          type: string
          description: Public description of the reward
        publicImage:
          type: string
          description: Public image URL of the reward
        publicName:
          type: string
          description: Public name of the reward
        createdAt:
          type: string
          format: date-time
          description: Timestamp when the reward was created
        updatedAt:
          type: string
          format: date-time
          description: Timestamp when the reward was last updated
      title: Reward_createReward_Response_200
    LoyaltyOfferProgramsPidVouchersGetParametersSortField:
      type: string
      enum:
      - updatedAt
      - createdAt
      default: updatedAt
      title: LoyaltyOfferProgramsPidVouchersGetParametersSortField
    LoyaltyOfferProgramsPidRewardsRidGetParametersVersion:
      t

# --- truncated at 32 KB (55 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/brevo/refs/heads/main/openapi/brevo-reward-api-openapi.yml