Offer API
The Offer API gives you read access to the live status, current price, stock level, and visibility of your products — one offer record per country and business model — across every market where you sell on noon. It is designed for sellers and ERP integrators who need to monitor catalog health, diagnose non-live listings, and verify that pricing or stock changes have taken effect.
This page is an overview. To make your first API call, see the Offer API Quickstart.
What you can do
- Retrieve the live status and current price of any SKU across all countries in a single call
- Identify why an offer is not visible to customers by inspecting its blocking issues
- Confirm that a price or stock update has propagated before triggering downstream workflows
- Run nightly reconciliation to verify every SKU in your catalog is live where expected
- Check available stock per country to prioritize replenishment or restocking jobs
Who should use this API
Use this API if:
- You run scheduled jobs to reconcile catalog state across countries
- You need to diagnose why a specific SKU is not appearing on the storefront
- You want to verify that a change made via the Pricing or Stock API has taken effect
- You build dashboards or alerting systems that monitor offer health at scale
This API is read-only — it does not modify offers. If you need to update prices or activate an offer, use the Pricing API. If you need to update stock quantities, use the Stock API.
Key concepts
Offer — A per-country, per-business-model record for a single partner SKU. A single SKU can have multiple offer records if you sell in more than one country. The offer_code uniquely identifies each record.
Business model — The operational context under which a product is sold. At noon, products can be sold under one or more business models: noon, supermall, and Global. The business_model field on each offer record identifies which one applies. The Offer API currently supports the noon business model only.
is_active vs live_status — is_active reflects whether you have activated the product for a given country — it is set via the Pricing API. live_status reflects whether the offer is currently visible to customers on the storefront. An offer can be is_active: true and live_status: false when there are unresolved blocking issues.
offer_issues — An array of blocking issues that prevent an offer from going live. Each issue includes a reason, subreason, and description. When live_status is false, always inspect this array to identify what is preventing the offer from appearing.
Key operations
| Operation | What it does | Guide | Reference |
|---|---|---|---|
GetProductOffers | Retrieves live status, price, stock, and any blocking issues for a partner SKU across all countries | Offer API Quickstart | Reference |
Next steps
- Offer API Quickstart — make your first call and inspect a live offer record
- GetProductOffers API Reference — full request and response schema
- Pricing API — update prices and activate offers per country
- UpdateStock — update stock quantities per warehouse