# GS1 Events API

**Canonical:** https://apis.io/apis/gs1/gs1-events-api/  
**Provider:** GS1 — https://apis.io/providers/gs1/  
**Base URL:** https://id.gs1.org  
**Documentation:** https://ref.gs1.org/standards/epcis/

GS1 Events API is one of 7 APIs that [GS1](https://apis.io/providers/gs1/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include Event. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 2 JSON Schemas.

Endpoints that allow you to retrieve EPCIS events as Web resources.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/events` | Returns all EPCIS events available in the EPCIS repository. |
| GET | `/events/{eventID}` | Returns an individual EPCIS event. |
| GET | `/eventTypes/{eventType}/events` | Returns EPCIS events of a given an EPCIS event type. |
| GET | `/epcs/{epc}/events` | Returns EPCIS events matching the specified electronic product code. |
| GET | `/bizSteps/{bizStep}/events` | Returns all EPCIS events related to the business step. |
| GET | `/bizLocations/{bizLocation}/events` | Returns all EPCIS events related to the business location. |
| GET | `/readPoints/{readPoint}/events` | Returns all EPCIS events related to the read point. |
| GET | `/dispositions/{disposition}/events` | Returns all EPCIS events related to the disposition. |
| GET | `/queries/{queryName}/events` | Returns EPCIS events with the option to use pagination if needed. This endpoint supports query subscriptions using WebSockets. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gs1/refs/heads/main/openapi/gs1-events-api-openapi.yml
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gs1/refs/heads/main/json-schema/gs1-epcis-json-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gs1/refs/heads/main/json-schema/gs1-epcis-query-schema.json
- **Specification** — https://ref.gs1.org/standards/epcis/2.0.1/
- **Documentation** — https://www.gs1.org/standards/epcis
- **Artefacts** — https://ref.gs1.org/standards/epcis/artefacts
- **Vocabulary** — https://ref.gs1.org/cbv/
- **SourceCode** — https://github.com/gs1/EPCIS

## Other GS1 APIs (6)

- [GS1 Digital Link Resolver (id.gs1.org)](https://apis.io/apis/gs1/gs1-digital-link-resolver/)
- [GS1 Capture API](https://apis.io/apis/gs1/gs1-capture-api/)
- [GS1 Discovery API](https://apis.io/apis/gs1/gs1-discovery-api/)
- [GS1 Queries API](https://apis.io/apis/gs1/gs1-queries-api/)
- [GS1 Subscriptions API](https://apis.io/apis/gs1/gs1-subscriptions-api/)
- [GS1 Top Level API](https://apis.io/apis/gs1/gs1-top-level-api/)

## Tags

Event

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gs1/gs1-events-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gs1/.