EPCIS 2.0 Events

​

Event Types

​

Event Structure

​

What (Identifiers)

• epcList — list of individual EPC/GTIN URIs involved
• quantityList — class-level quantities (GTIN without serial, plus quantity and UOM)
• parentID — container identifier for aggregation events
• inputEPCList / outputEPCList — for transformation events

​

When (Time)

• eventTime — when the event occurred (ISO 8601)
• eventTimeZoneOffset — timezone offset (e.g., +05:30)
• recordTime — when the system captured the event (set automatically)

​

Where (Location)

• readPoint — GS1 Digital Link URI of the scan location
• bizLocation — GS1 Digital Link URI of the business location

​

Why (Business Context)

• bizStep — business step from CBV 2.0 vocabulary (40+ values)
• disposition — object state after the event (20+ values)

​

Capturing Events

curl -X POST \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  https://www.closient.com/epcis/api/2.0/capture \
  -d '{
    "type": "ObjectEvent",
    "eventTime": "2026-04-01T12:00:00Z",
    "eventTimeZoneOffset": "+00:00",
    "action": "OBSERVE",
    "epcList": ["urn:epc:id:sgtin:0012345.078905.1"],
    "bizStep": "urn:epcglobal:cbv:bizstep:inspecting",
    "disposition": "urn:epcglobal:cbv:disp:in_progress",
    "readPoint": {"id": "urn:epc:id:sgln:0012345.00001.0"},
    "bizLocation": {"id": "urn:epc:id:sgln:0012345.00001.0"}
  }'

​

Business Step Vocabulary (CBV 2.0)

​

Disposition Vocabulary

​

Persistent Dispositions

• persistent_disposition_set — dispositions to add to the object’s persistent state
• persistent_disposition_unset — dispositions to remove

​

Instance/Lot Master Data (ILMD)

{
  "ilmd": {
    "bestBeforeDate": "2027-01-15",
    "countryOfOrigin": "US",
    "lotNumber": "LOT2026Q1"
  }
}

​

Querying Events

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://www.closient.com/epcis/api/2.0/events?GE_eventTime=2026-01-01T00:00:00Z&eventType=ObjectEvent"