Skip to main content

How to use the Pricing APIs?

These APIs allow you to view and manage your SKU pricing in bulk on noon. You can use these APIs to:

  • Retrieve your current prices, MSRP, and active status
  • Create or update pricing for multiple SKUs at once
  • Keep your pricing in sync with your internal systems
  • Manage large catalogs efficiently without updating SKUs one by one

Both APIs are designed for bulk operations and process each SKU independently.

Who should use these APIs?​

You should use these APIs if:

  • You update prices across many SKUs or countries at once
  • You want to validate pricing before running deals or campaigns
  • You need a reliable way to sync pricing data with the platform

API: BatchGetPricing​

Use this API when you need to retrieve your current pricing details for one or more SKUs.

When should you use this API?​

Use BatchGetPricing when:

  • You want to check the current selling price of your SKUs
  • You need to retrieve MSRP values configured on the platform
  • You want to confirm whether a SKU is active or inactive in a specific country
  • You need to validate pricing before making updates
  • This is a read-only API and does not change your pricing.

Request fields

  • partner_sku (string, required) - Your SKU identifier as defined in your system.
  • country_code (string, required) - The country where your SKU is listed (ISO country code, e.g. AE, SA).

Response fields

  • partner_sku (string) - The SKU you requested pricing for.
  • country_code (string) - The country associated with the pricing data.
  • status (object) - Indicates whether pricing was successfully retrieved for this SKU. If unsuccessful, this object provides details about the issue.
  • price (double, nullable) - Your current selling price. May be null if no price is set.
  • msrp (double, nullable) - Your MSRP value, if provided. May be null if not configured.
  • is_active (boolean, nullable) - Whether your SKU is currently active and available for sale.

Important notes​

  • Each SKU is processed independently.
  • Some SKUs may return pricing while others fail — always check the status field.
  • null values indicate that pricing or activation may not yet be configured.

API: BatchUpsertPricing​

Use this API when you need to create or update pricing in bulk.

When should you use this API?​

Use BatchUpsertPricing when:

  • You want to set pricing for new SKUs
  • You need to update existing prices or MSRP
  • You want to activate or deactivate SKUs
  • You are applying pricing changes across multiple countries at once

If pricing already exists for a given SKU and country, this API will update it. If it does not exist, the API will create it.

Request fields

  • partner_sku (string, required) - Your SKU identifier as defined in your system.
  • country_code (string, required) - The country where the pricing applies (ISO country code).
  • price (double, nullable) - The selling price you want to set or update. If null, the price will not be changed.
  • msrp (double, nullable) - The MSRP you want to set or update. If null, the MSRP will not be changed.
  • is_active (boolean, nullable) - Whether the SKU should be active for sale. If null, the activation status will not be changed.

Response fields

  • partner_sku (string) - The SKU you attempted to update.
  • country_code (string) - The country where the update was applied.
  • status (object) - Indicates whether the pricing update was successful or if it failed, along with relevant details.

Important notes​

  • Each SKU is processed independently.
  • Partial success is possible — always review the status per item.
  • Only the fields you provide (non-null) will be updated. null values do not remove pricing; they leave existing values unchanged.