# GS1 Discovery API

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

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

Endpoints to obtain information about the endpoint, such as EPCIS and CBV versions or custom vocabularies.

## Operations (30)

| Method | Path | Summary |
|---|---|---|
| OPTIONS | `/` | Query server settings, EPCIS version(s) and related vocabularies/standards. |
| GET | `/` | Returns the list of top level resources available for this EPCIS repository. |
| OPTIONS | `/capture` | Discover the settings of the capture interface. |
| OPTIONS | `/capture/{captureID}` | Query the metadata of the capture job endpoint. |
| OPTIONS | `/events` | Query metadata for the EPCIS events endpoint. |
| OPTIONS | `/events/{eventID}` | Query metadata for the endpoint to access an individual EPCIS event. |
| OPTIONS | `/eventTypes` | Query metadata for the EPCIS event types endpoint. |
| GET | `/eventTypes` | Returns all EPCIS event types currently available in the EPCIS repository. |
| OPTIONS | `/eventTypes/{eventType}` | Query metadata of the EPCIS event type endpoint. |
| OPTIONS | `/eventTypes/{eventType}/events` | Query the metadata of the endpoint to access EPCIS events by event type. |
| OPTIONS | `/epcs` | Query metadata related to the electronic product codes endpoint. |
| OPTIONS | `/epcs/{epc}` | Query metadata of the electronic product code. |
| OPTIONS | `/epcs/{epc}/events` | Query the metadata of the endpoint to access EPCIS events by EPC in a URN or constrained GS1 Digital Link form (URL encoded). |
| OPTIONS | `/bizSteps` | Query metadata related to the business steps endpoint. |
| OPTIONS | `/bizSteps/{bizStep}` | Query metadata of the endpoint to access an individual business step. |
| OPTIONS | `/bizSteps/{bizStep}/events` | Query the metadata of the endpoint to access EPCIS events by business step. |
| OPTIONS | `/bizLocations` | Query the metadata related to the business locations endpoint. |
| OPTIONS | `/bizLocations/{bizLocation}` | Query the metadata of the endpoint to access an individual business location. |
| OPTIONS | `/bizLocations/{bizLocation}/events` | Query the metadata of the endpoint to access EPCIS events by business location. |
| OPTIONS | `/readPoints` | Query the metadata related to the read points endpoint. |
| OPTIONS | `/readPoints/{readPoint}` | Query the metadata of the endpoint to access an individual read point. |
| OPTIONS | `/readPoints/{readPoint}/events` | Query the metadata of the endpoint to access EPCIS events by read point. |
| OPTIONS | `/dispositions` | Query the metadata related to the dispositions endpoint. |
| OPTIONS | `/dispositions/{disposition}` | Query the metadata of the endpoint to access an individual disposition. |
| OPTIONS | `/dispositions/{disposition}/events` | Query the metadata of the endpoint to access EPCIS events by disposition. |
| OPTIONS | `/queries` | Query the metadata of the EPCIS queries endpoint. |
| OPTIONS | `/queries/{queryName}` | Query the metadata of the named queries endpoint. |
| OPTIONS | `/queries/{queryName}/subscriptions` | Query the metadata of the subscriptions endpoint. |
| OPTIONS | `/queries/{queryName}/subscriptions/{subscriptionID}` | Query the metadata of the endpoint for an individual subscription. |
| OPTIONS | `/queries/{queryName}/events` | Query the metadata of the EPCIS events query result endpoint. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gs1/refs/heads/main/openapi/gs1-discovery-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 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/)
- [GS1 Top Level API](https://apis.io/apis/gs1/gs1-top-level-api/)

## Tags

Discovery

---

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