Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Yotpo Loyalty API

Loyalty and referrals customers, orders, and redemptions.

Yotpo Loyalty API is one of 4 APIs that Yotpo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Loyalty. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 4 operations across 4 paths, and defines 6 schemas. It is described by OpenAPI 3.0.1, at version 1.0.

Requests are made against 2 base URLs: https://api.yotpo.com, https://loyalty.yotpo.com/api/v2.

4 operations 4 paths 6 schemas 2 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0
Base URL
https://api.yotpo.com
Authentication
API Key, API Key, API Key
Terms of Service
Resource Areas
1

Authentication & Security 3

Yotpo Loyalty API declares 3 security schemes for authenticating requests. An API key is passed in the query as utoken (UToken). An API key is passed in the header as x-guid (LoyaltyGuid). An API key is passed in the header as x-api-key (LoyaltyApiKey).

  • UToken — OAuth access token obtained from POST /oauth/token.
  • LoyaltyGuid — Loyalty & Referrals account GUID.
  • LoyaltyApiKey — Loyalty & Referrals API key.

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 2 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Loyalty 4

Loyalty and referrals customers, orders, and redemptions.

GET
/customers
Fetch a loyalty customer's details.
getLoyaltyCustomer 1 param → 200
POST
/orders
Record a loyalty order.
createLoyaltyOrder body → 200
POST
/redemptions
Create a redemption.
createRedemption body → 200
GET
/redemption_options
List redemption options.
listRedemptionOptions → 200

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are LoyaltyCustomer (6 properties), LoyaltyOrder (4 properties), RedemptionOption (3 properties), RedemptionRequest (2 properties). Each schema is shown below with its type and property counts.

LoyaltyOrder
object
4 properties 2 required
RedemptionResponse
object
2 properties
RedemptionRequest
object
2 properties 2 required
RedemptionOption
object
3 properties
RedemptionOptionList
object
1 property
LoyaltyCustomer
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yotpo-loyalty-api-openapi.yml Raw ↑

Other APIs Yotpo publishes across the network.

Yotpo Authentication API
Yotpo Reviews API
Yotpo Subscriptions API