Get Item with Availability Information by POST operation

POST /o/op/1/itemAvailability

Returns items with the Availability information filtered by business location and SKUs. Accepts SKUs list in request body and other parameters as query parameters.

Query parameters

  • businessLocationId integer(int64) Required

    The unique identifier for the business location

  • page integer(int32)

    The page number, when paginating. Starts at 0.

    Minimum value is 0. Default value is 0.

  • size integer(int32)

    The items per page, when paginating

    Minimum value is 1, maximum value is 100. Default value is 25.

application/json

Body Required

  • skus array[string] Required

    List of SKUs to filter by

    At least 1 but not more than 50 elements.

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • data array[object]
      Hide data attributes Show data attributes object
      • sku string

        The SKU assigned to the item

      • count integer(int64)

        The count of available items

      • updatedAt string(date-time)

        The last update of the item count

    • metadata object
      Hide metadata attributes Show metadata attributes object
      • current object
        Hide current attributes Show current attributes object
        • page integer(int32)
        • pageSize integer(int32)
      • total integer(int32)
      • totalPages integer(int32)
  • 400 application/json

    Bad Request

    Hide response attributes Show response attributes object
    • timestamp string(date-time)

      The date and time at which the error occurred.

    • status integer

      The HTTP status code associated with the error.

    • error string

      A short description of the HTTP status code meaning.

    • message string

      A human-readable message providing more details about the error.

    • path string

      The request path where the error occurred.

POST /o/op/1/itemAvailability
curl \
 --request POST 'https://api.trial.lsk.lightspeed.app/o/op/1/itemAvailability?businessLocationId=45454565682155' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"skus":["string"]}'
Request examples
{
  "skus": [
    "string"
  ]
}
Response examples (200)
{
  "data": [
    {
      "sku": "string",
      "count": 42,
      "updatedAt": "2025-07-08T14:20:00Z"
    }
  ],
  "metadata": {
    "current": {
      "page": 42,
      "pageSize": 42
    },
    "total": 42,
    "totalPages": 42
  }
}
Response examples (400)
{
  "timestamp": "2023-11-07T22:18:49.101Z",
  "status": 400,
  "error": "Bad Request",
  "message": "Required request parameter 'businessLocationId' for method parameter type Long is not present",
  "path": "/op/1/saleRestrictedItems"
}