# Get Roast Details

Gets detailed information about roasts by their IDs.

Endpoint: POST /inventory.roast.getRoastDetailsByIds
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) representing the roasted lot IDs to filter the roast details.
    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.roastDetails` (array)

  - `result.roastDetails.roastTechnician` (object)
    Represents a reference to an object by its name.

  - `result.roastDetails.roastTechnician.name` (string)

  - `result.roastDetails.note` (string)
    Additional notes recorded for the roast.

  - `result.roastDetails.startTemperature` (object)
    The starting temperature at the beginning of the roast.

  - `result.roastDetails.startTemperature.amount` (number, required)
    The temperature amount represented as a floating-point number.
    Example: 25

  - `result.roastDetails.startTemperature.unit` (string, required)
    The temperature unit of measurement.
    Enum: "CELSIUS", "FAHRENHEIT"

  - `result.roastDetails.endTemperature` (object)
    The ending temperature at the conclusion of the roast.

  - `result.roastDetails.roastValue` (object)
    Color of the roasted beans before grinding.

  - `result.roastDetails.roastValue.amount` (number, required)
    The roast value amount represented as a floating-point number.
    Example: 55

  - `result.roastDetails.roastValue.unit` (string, required)
    The roast value unit of measurement.
    Enum: "AGTRON_GOURMET", "AGTRON_COMMERCIAL", "COLORTRACK", "DIPPER", "ESPRESSO_VISION", "NEUHAUS_NEOTEC", "PROBAT_COLORETTE", "HUNTER_L", "JAVALYTICS", "KONICA_MINOLTA", "TONINO", "LIGHTTELLS", "ROAMI", "ROASTRITE"

  - `result.roastDetails.roastValue2` (object)
    Color of the roasted beans after grinding.

  - `result.roastDetails.roastDuration` (object)
    The total duration of the roast process.

  - `result.roastDetails.roastDuration.amount` (number, required)
    The time amount represented as a floating-point number.
    Example: 30

  - `result.roastDetails.roastDuration.unit` (string, required)
    The time unit of measurement.
    Enum: "MILLISECOND", "SECOND", "MINUTE", "HOUR"

  - `result.roastDetails.firstCrackTime` (object)
    The time at which the first crack occurs during roasting relative to the start of the roast.

  - `result.roastDetails.colorChangeTime` (object)
    The time at which the color changes during roasting relative to the start of the roast.

  - `result.roastDetails.machine` (object)
    Represents a reference to an object by its name.

  - `result.roastDetails.roastedLot` (object)
    Represents a reference to an object by its name and unique identifier.

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

  - `result.roastDetails.roastedLot.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"