# 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][offer-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][pricing-intro]. If you need to update stock quantities, use the [Stock API][update-stock].

## 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][offer-quickstart] | [Reference][offer-api-get-offers] |

## Next steps

- [Offer API Quickstart][offer-quickstart] — make your first call and inspect a live offer record
- [GetProductOffers API Reference][offer-api-get-offers] — full request and response schema
- [Pricing API][pricing-intro] — update prices and activate offers per country
- [UpdateStock][update-stock] — update stock quantities per warehouse