Embed a global digital gift card marketplace directly into your product. The PointLabs Unified API gives you a live, multi-brand catalog, real-time availability checks, and order fulfillment — no manual catalog upkeep and no separate integration per supplier.
\nWhat you can build: a rewards or loyalty redemption store, a checkout add-on for gift cards, or an incentives flow inside an existing app — browse, price, and fulfill orders entirely through this one API.
\nGetting Started Before calling any Marketplace endpoint, exchange your API key for a Bearer access token using Client → Authenticate By Signature. Include the returned AccessToken in the Authorization: Bearer {token} header (or the collection's ••••••• variable) on every subsequent request.
Base URL All endpoints use the https://gateway-sandbox-backend-api-168696228707.me-central1.run.app variable. Switch the active environment (top right) between Sandbox and Production to point every request at the right base URL — nothing else in this collection changes.
Available APIs
\nClient – Exchange an issued API key for a Bearer access token. API keys themselves are issued by PointLabs during partner onboarding and are not self-service through this API.
\nMarketplace – Browse the gift card catalog, check availability, and place orders. Typical flow: Get Product Types / Get Gift Card Categories → Get Products (search + filter) → Get Product Details → Get Product Availability → Create Order → Get Order Details.
\nAuthorization Type: Bearer Token, obtained from Client → Authenticate By Signature. Tokens expire after ExpiresIn seconds (see response) — call that endpoint again to get a fresh one.
Format Every request and response in this API is application/json only — no XML or form-data variants exist anywhere.
Errors Failures use a consistent shape: { ValidationResults: { IsValid, FirstCode, FirstMessage, CombinedMessages } }, with FirstCode one of 400 (bad request / failed validation), 404 (not found), or 500 (unexpected server error). Each request below lists its specific error examples under its Responses tab.
Exchange a valid API key for a short-lived Bearer access token. Call this first — the returned AccessToken is required as a Bearer token on every endpoint in the Marketplace folder.
Authentication: none — this is the anonymous entry point into the API.
\nTokens expire after ExpiresIn seconds; call this endpoint again to get a fresh one when it does. API keys themselves are issued by PointLabs during partner onboarding.
Request: Provide below field information in request body.
\nAPIKey — The API key issued to your client during onboarding.Exchange an issued API key for the Bearer access token used by every endpoint in the Marketplace folder below.
\nAPI keys themselves are issued by PointLabs during partner onboarding and are not self-service through this API — this folder only covers exchanging a key you already have for a short-lived access token.
\nStart here — every other request in this collection depends on a token from Authenticate By Signature.
\n","_postman_id":"88d71d8e-74f7-4208-8b87-02bcd56c5971"},{"name":"Marketplace","item":[{"name":"Get Product Types","id":"d65bedb1-fe88-43c7-801d-6b503ed1d63c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"body":{"mode":"raw","raw":"","options":{"raw":{"language":"json"}}},"url":"https://gateway-sandbox-backend-api-168696228707.me-central1.run.app/v1/marketplace/Masters/getproducttypes","description":"List the product types (e.g. Gift Card, Loyalty points) used to classify catalog items.
\nAuthentication: Bearer token (see Client → Authenticate By Signature).
\nResponse: Lists all product types with below information.
\nproductAttributes: attributes of product
\nvariantAttributes: attributes of variant
\nUse a result's Id as the Filter.ProductType value on Get Products.
List gift card categories as key/value pairs.
\nAuthentication: Bearer token (see Client → Authenticate By Signature).
\nResponse: Lists all gift card categories as key/value pairs to filter gift card products using Get products API.
\nUse a result's value as the Filter.GiftCard.Category value on Get Products.
List the product collections available to your account, as key/value pairs. Results are scoped to the authenticated client, so different partners may see different collections.
\nAuthentication: Bearer token (see Client → Authenticate By Signature).
\nResponse: Lists all product collections as key/value pairs.
\nUse a result's Key as the Filter.Collection value on Get Products.
List loyalty-points redemption categories as key/value pairs.
\nAuthentication: Bearer token (see Client → Authenticate By Signature).
\nResponse: Lists all loyalty-points redemption categories as key/value pairs.
\nUse a result's value as the Filter.LoyaltyPoints.Category value on Get Products.
Search the gift card or loyalty points catalog with cursor-based pagination and optional filters.
\nAuthentication: Bearer token (see Client → Authenticate By Signature).
\nRequest: Request contains below query parameters
\nPagination: page forward with First/After, or backward with Last/Before (Relay-cursor style) — don't set both directions in the same request.
Filtering: narrow results with below filter inputs
\nFilter.Search -not mandatory (free text search on product name)
Filter.Collection - mandatory (see Get Product Collections)
Filter.ProductType - mandatory (see Get Product Types)
Filter.GiftCard.Category not mandatory (see Get Gift Card Categories),
Filter.GiftCard.CountryCode -mandatory for gift card product type(2 char ISO country code e.g. US)
Filter.GiftCard.Brand- not mandatory ( product brand name)
Filter.LoyaltyPoints.Category - not mandatory (see Get Loyalty Points Categories).
SortBy.Field (sort by field name as NAME) with SortBy.Direction (ASC/DESC).Response: Lists all products with variants for input query parameters. Response consist of below information.
\nProduct details: id,name, description, thumbnail url, media image url and product type.
\nattributes: list of product attribute/value pair
variants: list of variants for each product with name, price and list of attibute/value pair information.
validation error codes
\nFetch full details — pricing, variants, media — for a single product by ID.
\nAuthentication: Bearer token (see Client → Authenticate By Signature).
\nRequest : Use the Id returned by Get Products as ProductId query parameter.
Response: Details product with variants for input product id query parameter. Response consist of below information.
\nProduct detail: id,name, description, thumbnail url, media image url and product type.
\nattributes: list of product attribute/value pair
variants: list of variants for product with name, price and list of attibute/value pair information.
Check whether a specific product variant is currently in stock and purchasable. Call this immediately before Create Order — order creation does not automatically retry or roll back if the variant turns out to be unavailable.
\nAuthentication: Bearer token (see Client → Authenticate By Signature).
\nRequest: Provide Product Id and Variant Id returned from Get Products API or Get Product details API
\nResponse: provide IsAvailable response for product and variant id.
Place an order for a single product variant.
\nBefore calling this: confirm the variant is in stock via Get Product Availability.
\nAuthentication: Bearer token (see Client → Authenticate By Signature). The client and customer identity are taken from claims on your bearer token, not from the request body — you cannot place an order on behalf of a different client.
\nRequest: Provide below field information in request body.
\nProductId: Product Id of selected product
\nVariantId: Variant id of selected product
\nQuantity: Number of quantity. Maximum quantity for Gift product is 1 per request
\nCustomerRequiredInfo: Customer required information as key/value pair. Mandatory if product requires customer information as Getproducts API response.
\nValidation error codes
\nResponse: returns OrderId,OrderNumber and Status of order created. Use the returned OrderId with Get Order Details to check fulfillment status.
Fetch the order and line items details for a previously placed order.
\nAuthentication: Bearer token (see Client → Authenticate By Signature).
\nRequest: Provide OrderId value returned by Create Order.
Response: returns below information for input order id.
\nOrder details: provide details like orderId,orderNumber,status and total amount for order
orderLines: provide details like productName,variantName,quantity,unitPrice,totalPrice and productDetails as key/value pair for product variant ordered.
Browse the gift card catalog, check availability, and place orders.
\nAuthentication: every endpoint in this folder requires a Bearer access token. Obtain one first from Client → Authenticate By Signature, then set it as the Authorization: Bearer {token} header (or the collection's {{accessToken}} variable) on requests here.
Typical flow: Get Product Types / Get Gift Card Categories → Get Products (search + filter) → Get Product Details → Get Product Availability → Create Order → Get Order Details.
\n","_postman_id":"a596fada-58b1-4f0f-a627-c0e436ff5891"}],"variable":[{"key":"baseUrl","value":"https://gateway-sandbox-backend-api-168696228707.me-central1.run.app","type":"string"}]}