Offers

Get offer details

Retrieve detailed information about a specific offer by its ID. Returns the full offer object including product reference, variant details, pricing, subscription settings, and inventory status for key-based products.

Authorization

Public key
x-fngs-public-key<token>

In: header

Path Parameters

offerId*string

GET /v0/offers/:offerId Parameter

Formatuuid

Response Body

application/json

application/json

GET
/v0/offers/{offerId}
curl -X GET "https://example.com/v0/offers/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "status": "success",  "data": {    "offer": {      "object": "offer",      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "internalId": null,      "price": -1.7976931348623157e+308,      "originalPrice": null,      "recurringInterval": "day",      "recurringIntervalCount": null,      "trialInterval": "day",      "trialIntervalCount": null,      "currency": "AFN",      "limit": null,      "soldItems": 0,      "status": "DRAFT",      "name": null,      "description": null,      "region": "Global",      "platform": "Meta Quest",      "gtin": null,      "warningMessage": null    }  }}

Create a new offer POST

Create a new offer for a product. Offers define how a product can be purchased: - One-time purchase: Set price and currency, leave recurring fields empty - Subscription: Set price, currency, and recurring interval - Free: Set price to 0 For subscription offers, you can optionally configure trial periods.

Update an offer PATCH

Update an existing offer's details. Can modify name, price, and settings. Note that changing pricing on an active offer may affect existing subscription customers depending on your configuration.