# Retrieve a purchase offer > Retrieve a purchase offer by its identifier. {/* generated:versioned-pages - edit _pm-authored, not this file */} `GET /api/purchase_offers/{id}` Retrieves a Purchase Offer resource. Returns a single purchase offer by id, including its cost, validity period, and the variant, supplier, country and tax it applies to. ## Path parameters | Name | Type | Required | Description | | ---- | -------- | -------- | ------------------------- | | `id` | `string` | Yes | Purchase Offer identifier | ## Query parameters | Name | Type | Required | Description | | -------------- | ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `expand` | `string` | - | Comma-separated list of relations to embed as full objects instead of IRI strings. Supported values: `tax`, `supplier`, `variant`, `country`, `product`, `medias`. Tokens are independent; unknown values are silently ignored. `product` and `medias` embed the full `Product` object and the full `Media` objects on the embedded variant. Must be combined with `variant` to take visible effect. | | `properties[]` | `string[]` | - | Allows you to reduce the response to contain only the properties you need. If your desired property is nested, you can address it using nested arrays. Example: properties[]={propertyName}&properties[]={anotherPropertyName}&properties[{nestedPropertyParent}][]={nestedProperty} | ## Response **200** - Purchase Offer resource | Property | Type | Required | Description | | --------------------------------- | ----------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- | | `@context` | `string \| object` | - | | | `@id` | `string` | Yes | | | `@type` | `string` | Yes | | | `country` | `string \| Country \| null` | Yes | The country resource it belongs to. Requires the `instance_params:read` scope. Returned null when the scope is missing. | | `createdAt` | `string` | - | The date and time when the resource was created (ISO 8601 format). | | `discountPrice` | `EmbeddedMoneyResource \| null` | - | The discounted tax-included price, when a discount applies. | | `discountPricePerUnit` | `EmbeddedPricePerUnitResource \| null` | - | The discounted tax-included price per measurement reference unit, when a discount applies. | | `discountTaxExcludedPrice` | `EmbeddedMoneyResource \| null` | - | The discounted tax-excluded price, when a discount applies. | | `discountTaxExcludedPricePerUnit` | `EmbeddedPricePerUnitResource \| null` | - | The discounted tax-excluded price per measurement reference unit, when a discount applies. | | `endsAt` | `string \| null` | - | End date of the offer. | | `id` | `string` | - | The unique identifier of the purchase offer. | | `price` | `EmbeddedMoneyResource` | - | The tax-included price, computed from `taxExcludedPrice` and the referenced `Tax` rate. | | `pricePerUnit` | `EmbeddedPricePerUnitResource \| null` | - | The tax-included price expressed per measurement reference unit. | | `startsAt` | `string` | - | Start date of the offer. Defaults to the current date/time if not provided. | | `status` | `"/api/statuses/DRAFT" \| "/api/statuses/ACTIVE" \| "/api/statuses/ARCHIVED"` | - | The status of the offer. | | `supplier` | `string \| Supplier \| null` | Yes | The supplier resource it belongs to. Requires the `suppliers:read` scope. Returned null when the scope is missing. | | `tax` | `string \| Tax \| null` | Yes | The tax resource it belongs to. Requires the `instance_params:read` scope. Returned null when the scope is missing. | | `taxExcludedPrice` | `EmbeddedMoneyResource` | Yes | The price set for the offer, excluding tax. | | `taxExcludedPricePerUnit` | `EmbeddedPricePerUnitResource \| null` | - | The tax-excluded price expressed per measurement reference unit. | | `updatedAt` | `string` | - | The date and time when the resource was last modified (ISO 8601 format). | | `variant` | `string \| Product.Variant \| null` | Yes | The variant resource it belongs to. Requires the `products:read` scope. Returned null when the scope is missing. | ## Errors **403** - Access denied. The caller is missing one or more permissions required for this operation. | Property | Type | Required | Description | | -------------------- | ------------------ | -------- | ---------------------------------------------------------------------------------------------------------------------- | | `@context` | `string \| object` | - | | | `@id` | `string` | Yes | | | `@type` | `string` | Yes | | | `detail` | `string` | - | | | `missingPermissions` | `string[]` | - | Permissions that the caller is missing for this operation. Present only when the 403 is caused by a denied permission. | | `status` | `integer` | - | | | `title` | `string` | - | | | `type` | `string` | - | | **404** - Not found | Property | Type | Required | Description | | ------------- | ------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------ | | `@context` | `string \| object` | - | | | `@id` | `string` | Yes | | | `@type` | `string` | Yes | | | `code` | `string` | - | Stable identifier of the error in the error code catalogue (see /api/error-codes). Present on catalogued errors only. | | `description` | `string \| null` | - | | | `detail` | `string \| null` | - | A human-readable explanation specific to this occurrence of the problem. | | `instance` | `string \| null` | - | A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. | | `message` | `string` | - | End-user message localized in the request locale, with this occurrence's values substituted. Present on catalogued errors only. | | `slug` | `string` | - | Stable, readable key of the error in the error code catalogue. Present on catalogued errors only. | | `status` | `integer \| null` | - | | | `title` | `string \| null` | - | A short, human-readable summary of the problem. For a catalogued error it repeats the `slug`. | | `type` | `string` | - | A URI reference that identifies the problem type. For a catalogued error it is the error code resource, `/api/error-codes/{code}`. | ## Examples ### Example request ```bash curl -X GET 'https://.product-management.flowkiwi.net/api/purchase_offers/' \ -H 'Authorization: Bearer {access_token}' \ -H 'Flowkiwi-Api-Version: unstable' \ -H 'Accept: application/ld+json' ``` ### Example response ```json { "@context": "/api/contexts/Purchase%20Offer", "@id": "/api/purchase_offers/019af8e1-2b3c-7d4e-9f50-6b7c8d9e0f10", "@type": "Purchase Offer", "country": "/api/countries/019af8c2-3d4e-7f50-8a61-2b3c4d5e6f70", "createdAt": "2026-01-15T09:30:00+00:00", "discountPrice": { "@type": "EmbeddedMoneyResource", "amount": "7.20", "currency": "EUR" }, "discountPricePerUnit": { "@type": "EmbeddedPricePerUnitResource", "amount": "10.29", "currency": "EUR", "unit": "l", "value": 1 }, "discountTaxExcludedPrice": { "@type": "EmbeddedMoneyResource", "amount": "6.00", "currency": "EUR" }, "discountTaxExcludedPricePerUnit": { "@type": "EmbeddedPricePerUnitResource", "amount": "8.57", "currency": "EUR", "unit": "l", "value": 1 }, "endsAt": "2026-03-31T23:59:59+00:00", "id": "019af8e1-2b3c-7d4e-9f50-6b7c8d9e0f10", "price": { "@type": "EmbeddedMoneyResource", "amount": "7.80", "currency": "EUR" }, "pricePerUnit": { "@type": "EmbeddedPricePerUnitResource", "amount": "11.14", "currency": "EUR", "unit": "l", "value": 1 }, "startsAt": "2026-03-01T00:00:00+00:00", "status": "/api/statuses/ACTIVE", "supplier": "/api/suppliers/019af8c5-6a7b-7c8d-9e0f-4d5e6f708192", "tax": "/api/taxes/019af8c3-4e5f-7061-9b72-3c4d5e6f7081", "taxExcludedPrice": { "@type": "EmbeddedMoneyResource", "amount": "6.50", "currency": "EUR" }, "taxExcludedPricePerUnit": { "@type": "EmbeddedPricePerUnitResource", "amount": "9.29", "currency": "EUR", "unit": "l", "value": 1 }, "updatedAt": "2026-02-03T14:45:12+00:00", "variant": "/api/products/019af93e-420e-79f8-800b-6680f03dce20/variants/019af940-5a6b-7c8d-9e0f-1a2b3c4d5e6f" } ```