GET V1 fml/materialLots?materialId={materialId}

Gets the non-disposed Lots for the FReg Material with the specified ID.

Request Information

Parameters

Name Description Additional information
materialId 
The ID of the FReg Material to get the Lots for.

Define this parameter in the request URI.

Example Request

To get the Lots for the FReg Material with ID 1234, make the following API call: GET /fml/materialLots?materialId=1234

Response Information

HTTP Status Codes

Status Code Meaning
200 (OK) The request has completed successfully. The Material Lots will be contained in the response body (see below).
401 (Unauthorized) The user has not been authorised due to the below reasons which will be displayed in the response content.
API Key is not found. Data received apiKey
Secret Key is wrong. Data received apiKey
Username not found. Data received apiKey
Received token not found in EMS issuer. Data received username, version
Lifetime validation failed. The token is expired. ValidTo (UTC): expiry, Current time (UTC): UTC DateTime
Token creation failed. Reason: The given username or password is wrong. For input: username, version
Please ensure that the client provides the api-username and api-usertoken headers.

Response Detail

An empty collection means that the FReg material did not exist or it does not have any related Lots. Only Lots that have not been disposed of will be returned in the response.

Response Body Formats

application/json, text/json

Sample: 
[
  {
    "ID": 10001,
    "LotNumber": "Lot 1"
  },
  {
    "ID": 10002,
    "LotNumber": "Lot 2"
  }
]

application/xml, text/xml

Sample: 
<ArrayOfMaterialLot xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Unilever.Urdps.Hts.EmsApi.EntityRepresentations.FReg.V1">
  <MaterialLot>
    <ID>10001</ID>
    <LotNumber>Lot 1</LotNumber>
  </MaterialLot>
  <MaterialLot>
    <ID>10002</ID>
    <LotNumber>Lot 2</LotNumber>
  </MaterialLot>
</ArrayOfMaterialLot>