> ## Documentation Index
> Fetch the complete documentation index at: https://developer.fabric.inc/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Offers for Items by Item IDs
> Enables you to get offer price of items based on the item Ids.
## OpenAPI
````yaml offers_v1 post /api-price/offer/get-by-itemIds
openapi: 3.0.0
info:
description: >-
fabric e-commerce Offers APIs allow you to to set up and manage stock
keeping unit (SKU) prices. Its wide range of coupon and promotion features
let you design deals ranging from single-use, customer-specific coupons to
site-wide promotions.
version: 1.0.0
title: Offers v1
contact:
email: support@fabric.inc
license:
name: fabric API license
url: https://fabric.inc/api-license
servers:
- url: https://prod01-apigw.{customer_name}.fabric.zone
description: Production
variables:
customer_name:
default: yourcompany
description: Customer name, provided by support team
security: []
tags:
- name: Pricing
description: Pricing APIs enable you to add price details for one or many items.
- name: Promotions
description: >-
Promotion APIs enable you to apply and verify promotions and discount
coupons.
- name: Login API
description: >-
Login endpoint generates an authorization token for local users that they
can use to log into fabric copilot application.
**Note:** A
local user is someone who has an active account with fabric Inc
externalDocs:
description: Learn more about Offers
url: https://fabric.inc/knowledgebase/offers
paths:
/api-price/offer/get-by-itemIds:
post:
tags:
- Pricing
summary: Get Offers for Items by Item IDs
description: Enables you to get offer price of items based on the item Ids.
operationId: getPriceByItemIds
parameters:
- $ref: '#/components/parameters/xSiteContent'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/getItemPriceRequest'
responses:
'200':
description: >-
Successfully retrieves an array cotaining all the prices for items
based on items identifiers.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/priceInsertResponse'
'400':
description: Client Error
content:
application/json:
schema:
$ref: '#/components/schemas/clientError'
'500':
description: Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/serverError'
components:
parameters:
xSiteContent:
name: x-site-context
in: header
description: >-
The `x-site-context` header is a JSON object that contains information
about the source you wish to pull from. The mandatory `account` is the
24 character identifier found in Copilot. The `channel` (Sales channel
ID), `stage` (environment name), and `date` attributes can be used to
further narrow the scope of your data source.
required: true
schema:
type: string
example: >-
{"date": "2023-01-01T00:00:00.000Z", "channel": 12, "account":
"1234abcd5678efgh9ijklmno","stage":"production"}
schemas:
getItemPriceRequest:
type: object
description: Item Price Request Object
properties:
itemIds:
description: Comma seperated list of ItemIds
type: array
items:
type: number
description: Items
example: 1000000038
priceListId:
description: Price List ID
type: number
example: 100000
required:
- itemIds
priceInsertResponse:
type: object
description: Create Price Response
properties:
_id:
description: Identifier
type: string
example: 616e011037a3810008cfb256
priceListId:
description: Price List Identifier
type: number
example: 100000
isSoftDeleted:
description: Has been soft deleted
type: boolean
example: false
itemId:
description: Internal Item ID
type: number
example: 1000011218
itemSku:
description: Product SKU
type: string
example: 1234XYZ
offerId:
description: Offer ID
type: number
example: 371922
offers:
type: array
description: Offers
maxItems: 10
minItems: 1
items:
type: object
description: Item in Offer
properties:
kind:
description: Pricekind Id
type: number
example: 12
channel:
description: Channel Id
type: number
example: 12
startDate:
description: Price start date time
type: string
format: date-time
example: '2021-12-30T02:05:00.000Z'
endDate:
description: Price end date time
type: string
format: date-time
example: '2099-12-31T00:00:00.000Z'
price:
type: object
description: Price
properties:
base:
description: base price of item
type: number
example: 2000
sale:
description: sale price of item if any
type: number
example: 1000
cost:
description: Cost of Product
type: number
example: 800
currency:
description: Currency
type: string
example: USD
range:
type: array
description: Price ranges
items:
type: object
description: Items
properties:
_id:
description: ID
type: string
example: 616e143828d0b800086dd84a
minQuantity:
description: Min quantity
type: number
example: 2
price:
type: number
description: Price at min quantity
example: 500
createdAt:
type: string
description: Date and time of creation
format: date-time
example: '2021-10-18T23:19:44.852Z'
updatedAt:
type: string
description: Date and time of updated
format: date-time
example: '2021-10-19T00:40:30.341Z'
job:
description: Job
type: boolean
example: false
clientError:
type: object
properties:
code:
description: The error code, meant for machine consumption.
type: string
example: 400
message:
description: A human-readable description of the error that occurred.
type: string
example: SKU cannot be empty
serverError:
type: object
properties:
code:
description: The error code, meant for machine consumption.
type: string
example: 500
message:
description: A human-readable description of the error that occurred.
type: string
example: >-
An internal error occurred. If the issue persists please contact
support@fabric.inc.
````