Skip to main content
GET
/
epcis
/
api
/
2.0
/
traceability
/
lots
/
{lot_id}
/
blast-radius
Quantified downstream footprint for one lot
curl --request GET \
  --url https://www.closient.com/epcis/api/2.0/traceability/lots/{lot_id}/blast-radius \
  --header 'X-API-Key: <api-key>'
{
  "lot_id": "<string>",
  "downstream_lots": 1,
  "downstream_serials": 1,
  "downstream_locations": 1,
  "affected_organizations": 1
}

Documentation Index

Fetch the complete documentation index at: https://docs.closient.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
lot_id
string
required

Short ID of the ProductLot to compute the blast radius for — 22-character shortuuid encoding of the lot's UUID primary key.

Required string length: 22

Response

OK

Quantified downstream footprint of a single lot.

Counts are computed over events visible to the requesting organization — same access semantics as trace_forward.

​
lot_id
string
required

Short ID of the source lot the radius was computed for — echoed from the path parameter. 22-character shortuuid encoding.

Required string length: 22
​
downstream_lots
integer
required

Distinct ProductLots reached by walking forward CriticalTrackingEvents from the source lot, excluding the source lot itself. Zero when the lot has not yet been observed in any forward event.

Required range: x >= 0
​
downstream_serials
integer
required

Total serialized EPCs (sum of epcList sizes) allocated across the downstream lots. Approximates the number of physical units potentially affected by a recall on the source lot.

Required range: x >= 0
​
downstream_locations
integer
required

Distinct ship-to GLNs across SHIP CTEs on the source lot or any of its downstream derivatives. Counts unique destination locations (a single location with many shipments counts once).

Required range: x >= 0
​
affected_organizations
integer
required

Distinct trading-partner recipients (resolved via OWNING_PARTY destinations on SHIP CTEs) across the forward chain.

Required range: x >= 0