# Get Roasted Lots by IDs

Retrieves roasted lots based on the provided list of IDs.

Endpoint: POST /inventory.roast.getRoastedLotsByIds
Security: oauth2

## Request fields (application/json):

  - `params` (object)

  - `params.filter` (object)
    Defines all required and optional filter parameters for the operation.

  - `params.filter.roastedLotIds` (array, required)
    A set of unique identifiers (UUIDs) of roasted lots to fetch
    Example: ["123e4567-e89b-12d3-a456-426614174000","123e4567-e89b-12d3-a456-426614174001"]

  - `params.pagination` (object)
    Defines all required and optional pagination parameters for the operation.

  - `params.pagination.limit` (integer)
    The number of elements to be returned
    Example: 20

  - `params.pagination.after` (string)
    The cursor to retrieve the next page. This is an opaque value that should not be interpreted by the client.
    Example: "aBc="

## Response 200 fields (application/json):

  - `ok` (boolean)
    Indicates whether the request was successful.
    Example: true

  - `result` (object)
    Contains the response data of a successful request.

  - `result.roastedLots` (array)

  - `result.roastedLots.id` (string)
    The unique identifier of the roasted lot.
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `result.roastedLots.lotNumber` (string)
    A human-readable identifier for a roasted lot.
    Example: "PR-1234"

  - `result.roastedLots.name` (string)
    The name of the roasted lot.
    Example: "Colombia Washed"

  - `result.roastedLots.weight` (object)
    Represents the current weight of the object.

  - `result.roastedLots.weight.amount` (number, required)
    The weight amount represented as floating-point number.
    Example: 12.5

  - `result.roastedLots.weight.unit` (string, required)
    The weight unit of the object.
    Enum: "KG", "LBS"

  - `result.roastedLots.weightLoss` (object)
    Represents the weight loss during roasting.

  - `result.roastedLots.greenLots` (array)
    The green lots that were used for roasting.

  - `result.roastedLots.greenLots.id` (string)
    The unique identifier of the lot.
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `result.roastedLots.greenLots.name` (string)
    The name of the lot.
    Example: "Colombia Washed"

  - `result.roastedLots.greenLots.externalId` (string)
    Represents the unique identifier of this lot in an external system (e.g. ERP).
    Example: "lot-5382"

  - `result.roastedLots.greenLots.usedWeight` (object)
    The amount of weight consumed from the source lot for a specified operation. (e.g. roasting, blending). For example, 5 KG of a green lot were consumed for roasting.

  - `result.roastedLots.profile` (object)
    The profile that was used for roasting the lot.

  - `result.roastedLots.profile.id` (string)
    The unique id of the profile.
    Example: "09afcba6-60db-4d44-b359-008911790897"

  - `result.roastedLots.profile.name` (string)
    The name of the profile.
    Example: "Light Roast"

  - `result.roastedLots.profile.externalId` (string)
    Represents the unique identifier this profile in an external system (e.g. ERP).
    Example: "light-roast"

  - `result.roastedLots.location` (object)
    Represents the relationship between an internal object and its external identifier.

  - `result.roastedLots.location.id` (string)
    The unique identifier of the object.
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `result.roastedLots.location.externalId` (string)
    Represents the unique identifier of this object in an external system (e.g. ERP).
    Example: "location-1234"

  - `result.roastedLots.roastedDate` (string)
    The date when the lot was roasted in ISO 8601 format
    Example: "2023-10-05T14:48:00Z"

  - `result.roastedLots.projects` (array)
    The projects that the roasted lot belongs to.

  - `result.roastedLots.projects.name` (string)
    The name of the Object.
    Example: "Sample object name"

## Response 400 fields (application/json):

  - `ok` (boolean)
    Indicates whether the request was successful or not

  - `error` (object)

  - `error.code` (string)
    Specifies error code that can be handled programmatically.
    Example: "invalid_parameter"

  - `error.message` (string)
    A detailed description of the occurred error.
    Example: "Invalid parameter provided"

## Response 401 fields (application/json):

  - `ok` (boolean)
    Indicates whether the request was successful or not

  - `error` (object)

  - `error.code` (string)
    Specifies error code that can be handled programmatically.
    Example: "invalid_parameter"

  - `error.message` (string)
    A detailed description of the occurred error.
    Example: "Invalid parameter provided"

## Response 403 fields (application/json):

  - `ok` (boolean)
    Indicates whether the request was successful or not

  - `error` (object)

  - `error.code` (string)
    Specifies error code that can be handled programmatically.
    Example: "invalid_parameter"

  - `error.message` (string)
    A detailed description of the occurred error.
    Example: "Invalid parameter provided"

## Response 422 fields (application/json):

  - `ok` (boolean)
    Indicates whether the request was successful or not

  - `error` (object)

  - `error.code` (string)
    Specifies error code that can be handled programmatically.
    Example: "invalid_parameter"

  - `error.message` (string)
    A detailed description of the occurred error.
    Example: "Invalid parameter provided"

## Response 500 fields (application/json):

  - `ok` (boolean)
    Indicates whether the request was successful or not

  - `error` (object)

  - `error.code` (string)
    Specifies error code that can be handled programmatically.
    Example: "invalid_parameter"

  - `error.message` (string)
    A detailed description of the occurred error.
    Example: "Invalid parameter provided"