Skip to main content

How to use the Offer APIs?

An offer is the listing of your product on noon for a specific country and business model. When you sell on noon, each product you list becomes an offer — it carries its own price, stock level, and live status per country and business model.

A business model determines the operational context under which your product is sold. At noon, your products can be sold under any one or all of these business models: noon, supermall, and Global. Currently, the Offer API supports the noon business model.

These APIs allow you to retrieve offer details for your products across all supported countries. You can use these APIs to:

  • Check the live status of your offers across different countries
  • Check offer pricing per country
  • Identify issues preventing your offers from going live
  • Monitor stock availability per country
  • Identify if the product is activated by you in each country

API: GetProductOffers​

Use this API when you need to retrieve offer details for a specific product across all countries. This API currently only supports the noon business model.

When should you use this API?​

Use GetProductOffers when:

  • You want to check if a product offer is live in a specific country
  • You need to check the current price of an offer
  • You want to find out why an offer is not live (via offer_issues)
  • You need to verify the available active net stock for an offer
  • Note: This is a read-only API and does not modify your offers.

Request fields

  • partner_sku (string, required) - Your partner SKU (PSKU) is your internal unique identifier for the product as defined in your system.

Response fields

  • partner_sku (string) - The partner SKU (PSKU) identifier you requested
  • sku (string) - noon's SKU identifier associated with this product
  • title (string) - The product title
  • brand (string) - The product brand name
  • offers (array) - List of offers for this product across all countries. Each offer contains:
    • offer_code (string) - Unique identifier for the offer
    • country_code (string) - The country where the offer is available (e.g., ae, sa, eg)
    • business_model (string) - The business model under which the offer is available. Currently returns noon.
    • price (object, nullable) - Current price of the offer, containing:
      • amount (double) - The final price of the offer. The final price can be a a regular price, sale price, or deal price.
      • currency (string) - The currency code (e.g., AED, SAR, EGP)
    • is_active (boolean) - Whether the product is actived by the seller for this country
    • active_net_stock (integer) - Available net stock for the offer
    • live_status (boolean) - Whether the offer is currently live in the country
    • offer_issues (array) - List of issues preventing the offer from going live. Each issue contains:
      • reason (string) - The issue reason
      • subreason (string) - The issue sub-reason
      • description (string) - A human-readable description of the issue

Important notes​

  • A single product may have multiple offers — the same product will have a different offer per country and business model combination.
  • If live_status is false, inspect offer_issues to understand what is blocking the offer from going live.
  • is_active reflects the activation state of the product set by the seller, whereas live_status reflects actual visibility of the offer to customers — an active offer may still not be live due to issues.
  • price may be null if no price has been configured for the offer.
  • offer_issues will be empty when the offer has no issues is live.