---
updatedAt: 2026-09-24T22:59:05.000Z
agentTools:
  projectIndex: https://developers.getbyrd.com/llms.txt
---

# List the lots received in a delivery

Returns one entry per lot received with the delivery and the amount
received of it, ordered by SKU and lot number. Only products with
lots enabled appear, and the list is empty until the delivery has
been inbounded. See
[Listing the lots of a delivery](doc:listing-the-lots-of-a-delivery).

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "description": "The byrd APIs for managing products, inbound deliveries, shipments and returns.",
    "contact": {
      "email": "info@getbyrd.com",
      "name": "General company contact",
      "url": "https://getbyrd.com/kontakt/"
    },
    "license": {
      "name": "Copyright byrd technologies GmbH"
    },
    "termsOfService": "https://getbyrd.com/agb/",
    "version": "20261118",
    "title": "byrd APIs"
  },
  "servers": [
    {
      "description": "Production server",
      "url": "https://api.getbyrd.com/"
    }
  ],
  "security": [
    {
      "tokenAuth": []
    }
  ],
  "paths": {
    "/v2/warehouse/deliveries/{delivery_id}/lots": {
      "get": {
        "operationId": "deliverylotsapi_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "data"
                  ],
                  "properties": {
                    "data": {
                      "type": "array",
                      "items": {
                        "$ref": "#/components/schemas/DeliveryReceivedLot"
                      }
                    }
                  }
                }
              }
            },
            "description": "Success response to a valid request"
          },
          "400": {
            "$ref": "#/components/responses/Error"
          },
          "403": {
            "$ref": "#/components/responses/Error"
          }
        },
        "tags": [
          "Inbound"
        ],
        "description": "Returns one entry per lot received with the delivery and the amount\nreceived of it, ordered by SKU and lot number. Only products with\nlots enabled appear, and the list is empty until the delivery has\nbeen inbounded. See\n[Listing the lots of a delivery](doc:listing-the-lots-of-a-delivery).",
        "x-byrd-roles": [
          "warehouse_support",
          "admin",
          "service",
          "warehouse",
          "customer_support",
          "operator",
          "customer"
        ],
        "parameters": [
          {
            "name": "delivery_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "ID of the delivery (UUID)."
          }
        ],
        "summary": "List the lots received in a delivery"
      }
    }
  },
  "components": {
    "securitySchemes": {
      "tokenAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "Authorization with previously obtained JSON Web Token"
      }
    },
    "responses": {
      "Error": {
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        },
        "description": "Generic error response"
      }
    },
    "schemas": {
      "DeliveryReceivedLot": {
        "type": "object",
        "properties": {
          "productID": {
            "type": "string",
            "format": "uuid",
            "readOnly": true,
            "description": "ID of the product the lot belongs to (UUID)."
          },
          "sku": {
            "type": "string",
            "readOnly": true,
            "description": "Your SKU of the product; `null` when the product has none.",
            "nullable": true
          },
          "lotID": {
            "type": "string",
            "format": "uuid",
            "readOnly": true,
            "description": "ID of the lot (UUID)."
          },
          "lotNumber": {
            "type": "string",
            "readOnly": true,
            "description": "Lot (batch) number."
          },
          "expiryDate": {
            "type": "string",
            "format": "date",
            "readOnly": true,
            "description": "Date the lot expires on (ISO 8601 date); `null` when the lot has no expiry date.",
            "nullable": true
          },
          "amountReceived": {
            "type": "integer",
            "readOnly": true,
            "description": "Number of units of the lot received with this delivery. When the lot was put away several times, the amounts are added up."
          }
        },
        "title": "Delivery received lot"
      },
      "Error": {
        "type": "object",
        "required": [
          "code",
          "message",
          "errors"
        ],
        "properties": {
          "code": {
            "type": "string",
            "enum": [
              "Authentication.AuthenticationRequired",
              "Authentication.ExpiredJWTToken",
              "Authentication.InvalidCredentials",
              "Authentication.InvalidJWTToken",
              "Authentication.LocalityRequired",
              "Authentication.MissingPermission",
              "Authentication.ReadOnly",
              "Authentication.RoleNotAllowed",
              "Authentication.UserLocked",
              "Exception.404",
              "Exception.500",
              "Request.InvalidPagination",
              "Request.InvalidQuery",
              "Request.InvalidSchema",
              "Request.NoInput",
              "Request.ResourceNotFound"
            ]
          },
          "message": {
            "type": "string"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Embedded instance of Error"
            }
          }
        },
        "title": "Error"
      }
    }
  },
  "tags": [
    {
      "name": "Inbound",
      "description": "Deliveries of your stock to a warehouse: announce them, follow them in, and manage their documents."
    }
  ],
  "x-readme": {
    "apply-tag-changes": true,
    "apply-endpoint-order": true
  }
}
```