---
title: "Get an offer"
method: GET
path: "/v1/offers/{offerid}"
tags: ["Retrieve Offer (Synchronous API)"]
---

# Get an offer

`GET /v1/offers/{offerid}`

Get an offer.

## Path parameters

- `offerid` number, required

## Query parameters

- `version` string

## Headers

- `x-siteId` string, required
- `x-erid-as-oid` string

## Response `200`

Offer successfully retrieved.

- GetOffer
  - `id` string — Identifier of an offer.
  - `status` string — Status of an offer.
  - `name` string — Name of an offer.
  - `description` string — A description of the offer.
  - `externalReferenceOfferId` string — The external reference identifier for the offer.
  - `siteId` string — The site ID associated with the offer.
  - `offerType` string — The type of offer.
  - `offerTrigger` string — Specifies how the offer is triggered. Possible values include alwaysTriggered, couponCode, siteTest.
  - `offerStartDate` string — The start date of the offer.
  - `offerEndDate` string — End date of an offer. End date must be a future date.
  - `creationDate` string — Date of creation of an offer.
  - `modificationDate` string — Date of modification of an offer .
  - `defaultLocale` string — The end date of the offer.
  - `supportedLocales` object[] — The locales supported by the offer.
    - `locale` string — The supported locale for an offer. The en_US locale is also supported
  - `totalUsageLimit` number — The total usage limit for the offer.
  - `shopperUsageLimit` number — The usage limit per shopper for the offer.
  - `catalogId` string — The catalog associated with the offer.
  - `currency` string — The currency of the offer.
  - `priceListType` string — The price list of the offer.
  - `products` object[] — Eligibility and discount details for the products included in the offer.
    - `id` string — The product identifier.
    - `discountType` string — The type of discount applied to the product. Possible values include amountOff, percentOff.
    - `discountValue` number — Discount value of the product.

## Other responses

- `400` — * Bad request.
- `401` — * Please verify your API key and secret (if applicable) is correct.
- `403` — * Offer with provided external reference identifier is not unique on the site.
- `404` — * offer not found.

---

[API](https://skmtc.net/digitalriver/apis/commerce-api-suite-admin-apis.md) · [All operations](https://skmtc.net/digitalriver/apis/commerce-api-suite-admin-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalriver/commerce-api-suite-admin-apis/revisions/a6efafc1669c/schema)