Get received items for a purchase order
Scope: inventory:purchase-orders.read https://api.alladdin.com/api/v2/purchase-orders/{purchaseOrderId}/received-items
Returns the items that have already been received for this purchase order.
The response includes received quantities and pending quantities for each line item, so you can track receipt progress.
Parameters
Path parameters
purchaseOrderId string required
Purchase Order ID (24-char hex ObjectId)
Request
import requests
url = "https://api.alladdin.com/api/v2/purchase-orders/{purchaseOrderId}/received-items"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Responses
Response
{
"items": [
{
"sku": "SKU-001",
"name": "Widget A",
"total": 10,
"received": 6,
"pending": 4
}
]
}Success responses
200 Received items application/json object items[] object[] sku string required
Stock Keeping Unit code
name string required
Product name
total number required
Total units ordered
received number required
Units already received
pending number required
Units pending receipt
Error responses
401 Invalid or missing API key application/json 403 Insufficient permissions application/json 404 Purchase order not found application/json 429 Rate limit exceeded application/json