# GS1 Top Level API

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

GS1 Top Level 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 Top-level. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 2 JSON Schemas.

Endpoints to browse or retrieve information about EPCIS resources: - events - types of events - electronic product codes - business steps - business locations - read points - dispositions

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| GET | `/events` | Returns all EPCIS events available in the EPCIS repository. |
| GET | `/eventTypes` | Returns all EPCIS event types currently available in the EPCIS repository. |
| GET | `/eventTypes/{eventType}` | Returns all sub-resources of an EPCIS event type. |
| GET | `/epcs` | Returns known electronic product codes. |
| GET | `/epcs/{epc}` | Returns all sub-resources of an electronic product code. |
| GET | `/bizSteps` | Returns known business steps. |
| GET | `/bizSteps/{bizStep}` | Returns all sub-resources of a business step. |
| GET | `/bizLocations` | Returns known business locations. |
| GET | `/bizLocations/{bizLocation}` | Returns all sub-resources of a business location. |
| GET | `/readPoints` | Returns known read points. |
| GET | `/readPoints/{readPoint}` | Returns all sub-resources of a read point. |
| GET | `/dispositions` | Returns known dispositions. |
| GET | `/dispositions/{disposition}` | Returns all sub-resources of a disposition. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gs1/refs/heads/main/openapi/gs1-top-level-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 Events API](https://apis.io/apis/gs1/gs1-events-api/)
- [GS1 Queries API](https://apis.io/apis/gs1/gs1-queries-api/)
- [GS1 Subscriptions API](https://apis.io/apis/gs1/gs1-subscriptions-api/)

## Tags

Top-level

---

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