GS1

GS1 Events API

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

GitHub OpenAPI

Operations 9

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.

Documentation

📖
Documentation
https://www.gs1.org/standards/epcis

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/gs1/refs/heads/main/openapi/gs1-events-api-openapi.yml

Schemas & Data

📊
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

Other Resources

🔗
Specification
https://ref.gs1.org/standards/epcis/2.0.1/
🔗
Artefacts
https://ref.gs1.org/standards/epcis/artefacts
🔗
Vocabulary
https://ref.gs1.org/cbv/
🔗
SourceCode
https://github.com/gs1/EPCIS

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/gs1-events-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

gs1-events-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 2.0.1
  title: EPCIS 2.0 REST Bindings Events API
  license:
    name: Apache2
  description: 'Endpoints that allow you to retrieve EPCIS events as Web resources.

    '
tags:
- name: Events
  description: 'Endpoints that allow you to retrieve EPCIS events as Web resources.

    '
paths:
  /events:
    parameters:
    - $ref: '#/components/parameters/GS1-Extensions'
    get:
      tags:
      - Events
      summary: Returns all EPCIS events available in the EPCIS repository.
      parameters:
      - $ref: '#/components/parameters/NextPageToken'
      - $ref: '#/components/parameters/PerPage'
      - $ref: '#/components/parameters/GS1-CBV-Min'
      - $ref: '#/components/parameters/GS1-CBV-Max'
      - $ref: '#/components/parameters/GS1-EPCIS-Min'
      - $ref: '#/components/parameters/GS1-EPCIS-Max'
      - $ref: '#/components/parameters/GS1-EPC-Format'
      - $ref: '#/components/parameters/GS1-CBV-XML-Format'
      - $ref: '#/components/parameters/eventType'
      - $ref: '#/components/parameters/GE_eventTime'
      - $ref: '#/components/parameters/LT_eventTime'
      - $ref: '#/components/parameters/GE_recordTime'
      - $ref: '#/components/parameters/LT_recordTime'
      - $ref: '#/components/parameters/EQ_action'
      - $ref: '#/components/parameters/EQ_bizStep'
      - $ref: '#/components/parameters/EQ_disposition'
      - $ref: '#/components/parameters/EQ_persistentDisposition_set'
      - $ref: '#/components/parameters/EQ_persistentDisposition_unset'
      - $ref: '#/components/parameters/EQ_readPoint'
      - $ref: '#/components/parameters/WD_readPoint'
      - $ref: '#/components/parameters/EQ_bizLocation'
      - $ref: '#/components/parameters/WD_bizLocation'
      - $ref: '#/components/parameters/EQ_transformationID'
      - $ref: '#/components/parameters/MATCH_epc'
      - $ref: '#/components/parameters/MATCH_parentID'
      - $ref: '#/components/parameters/MATCH_inputEPC'
      - $ref: '#/components/parameters/MATCH_outputEPC'
      - $ref: '#/components/parameters/MATCH_anyEPC'
      - $ref: '#/components/parameters/MATCH_epcClass'
      - $ref: '#/components/parameters/MATCH_inputEPCClass'
      - $ref: '#/components/parameters/MATCH_outputEPCClass'
      - $ref: '#/components/parameters/MATCH_anyEPCClass'
      - $ref: '#/components/parameters/EQ_quantity'
      - $ref: '#/components/parameters/GT_quantity'
      - $ref: '#/components/parameters/GE_quantity'
      - $ref: '#/components/parameters/LT_quantity'
      - $ref: '#/components/parameters/LE_quantity'
      - $ref: '#/components/parameters/EQ_eventID'
      - $ref: '#/components/parameters/EXISTS_errorDeclaration'
      - $ref: '#/components/parameters/GE_errorDeclarationTime'
      - $ref: '#/components/parameters/LT_errorDeclarationTime'
      - $ref: '#/components/parameters/EQ_errorReason'
      - $ref: '#/components/parameters/EQ_correctiveEventID'
      - $ref: '#/components/parameters/orderBy'
      - $ref: '#/components/parameters/orderDirection'
      - $ref: '#/components/parameters/eventCountLimit'
      - $ref: '#/components/parameters/maxEventCount'
      - $ref: '#/components/parameters/GE_startTime'
      - $ref: '#/components/parameters/LT_startTime'
      - $ref: '#/components/parameters/GE_endTime'
      - $ref: '#/components/parameters/LT_endTime'
      - $ref: '#/components/parameters/EQ_type'
      - $ref: '#/components/parameters/EQ_deviceID'
      - $ref: '#/components/parameters/EQ_dataProcessingMethod'
      - $ref: '#/components/parameters/EQ_microorganism'
      - $ref: '#/components/parameters/EQ_chemicalSubstance'
      - $ref: '#/components/parameters/EQ_bizRules'
      - $ref: '#/components/parameters/EQ_stringValue'
      - $ref: '#/components/parameters/EQ_hexBinaryValue'
      - $ref: '#/components/parameters/EQ_uriValue'
      - $ref: '#/components/parameters/EQ_booleanValue'
      description: "This endpoint allows querying EPCIS events that are currently in the repository. \nEvents can be filtered through URL query string parameters as specified by the EPCIS Query Language. \nAn EPCIS 2.0 query body using the REST interface SHALL be serialised as a JSON object. The value of the query key within that JSON object SHALL validate against the schema defined at:  https://ref.gs1.org/standards/epcis/2.0.1/query-schema.json.\nAn EPCIS 2.0 query may also be expressed via parameters in the URI query string.  The query parameters with fixed fieldnames are included in this OpenAPI interface.  However, this list is not exhaustive and the EPCIS 2.0 standard defines additional query parameters with flexible names, depending on the specific value of `uom`, `type` or `fieldname` that appears within the name of the parameter.\n"
      responses:
        '200':
          $ref: '#/components/responses/200EPCISQueryDocument'
        '401':
          $ref: '#/components/responses/401UnauthorizedRequest'
        '403':
          $ref: '#/components/responses/403ClientUnauthorized'
        '406':
          $ref: '#/components/responses/406NotAcceptable'
        '414':
          $ref: '#/components/responses/414URLTooLong'
        '500':
          $ref: '#/components/responses/500ImplementationException'
  /events/{eventID}:
    parameters:
    - $ref: '#/components/parameters/EventID'
    - $ref: '#/components/parameters/GS1-Extensions'
    get:
      tags:
      - Events
      summary: Returns an individual EPCIS event.
      parameters:
      - $ref: '#/components/parameters/GS1-CBV-Min'
      - $ref: '#/components/parameters/GS1-CBV-Max'
      - $ref: '#/components/parameters/GS1-EPCIS-Min'
      - $ref: '#/components/parameters/GS1-EPCIS-Max'
      - $ref: '#/components/parameters/GS1-EPC-Format'
      - $ref: '#/components/parameters/GS1-CBV-XML-Format'
      description: "This endpoint accesses individual events using their unique identifier. The response body is an `EPCISQueryDocument` \nenclosing the unique event and error declarations.\n"
      responses:
        '200':
          $ref: '#/components/responses/200EPCISQueryDocumentSinglePage'
        '401':
          $ref: '#/components/responses/401UnauthorizedRequest'
        '403':
          $ref: '#/components/responses/403ClientUnauthorized'
        '404':
          $ref: '#/components/responses/404ResourceNotFound'
        '406':
          $ref: '#/components/responses/406NotAcceptable'
        '500':
          $ref: '#/components/responses/500ImplementationException'
  /eventTypes/{eventType}/events:
    parameters:
    - $ref: '#/components/parameters/EventType'
    - $ref: '#/components/parameters/GS1-Extensions'
    get:
      tags:
      - Events
      summary: 'Returns EPCIS events of a given an EPCIS event type.

        '
      parameters:
      - $ref: '#/components/parameters/NextPageToken'
      - $ref: '#/components/parameters/PerPage'
      - $ref: '#/components/parameters/GS1-CBV-Min'
      - $ref: '#/components/parameters/GS1-CBV-Max'
      - $ref: '#/components/parameters/GS1-EPCIS-Min'
      - $ref: '#/components/parameters/GS1-EPCIS-Max'
      - $ref: '#/components/parameters/GS1-EPC-Format'
      - $ref: '#/components/parameters/GS1-CBV-XML-Format'
      - $ref: '#/components/parameters/GE_eventTime'
      - $ref: '#/components/parameters/LT_eventTime'
      - $ref: '#/components/parameters/GE_recordTime'
      - $ref: '#/components/parameters/LT_recordTime'
      - $ref: '#/components/parameters/EQ_action'
      - $ref: '#/components/parameters/EQ_bizStep'
      - $ref: '#/components/parameters/EQ_disposition'
      - $ref: '#/components/parameters/EQ_persistentDisposition_set'
      - $ref: '#/components/parameters/EQ_persistentDisposition_unset'
      - $ref: '#/components/parameters/EQ_readPoint'
      - $ref: '#/components/parameters/WD_readPoint'
      - $ref: '#/components/parameters/EQ_bizLocation'
      - $ref: '#/components/parameters/WD_bizLocation'
      - $ref: '#/components/parameters/EQ_transformationID'
      - $ref: '#/components/parameters/MATCH_epc'
      - $ref: '#/components/parameters/MATCH_parentID'
      - $ref: '#/components/parameters/MATCH_inputEPC'
      - $ref: '#/components/parameters/MATCH_outputEPC'
      - $ref: '#/components/parameters/MATCH_anyEPC'
      - $ref: '#/components/parameters/MATCH_epcClass'
      - $ref: '#/components/parameters/MATCH_inputEPCClass'
      - $ref: '#/components/parameters/MATCH_outputEPCClass'
      - $ref: '#/components/parameters/MATCH_anyEPCClass'
      - $ref: '#/components/parameters/EQ_quantity'
      - $ref: '#/components/parameters/GT_quantity'
      - $ref: '#/components/parameters/GE_quantity'
      - $ref: '#/components/parameters/LT_quantity'
      - $ref: '#/components/parameters/LE_quantity'
      - $ref: '#/components/parameters/EQ_eventID'
      - $ref: '#/components/parameters/EXISTS_errorDeclaration'
      - $ref: '#/components/parameters/GE_errorDeclarationTime'
      - $ref: '#/components/parameters/LT_errorDeclarationTime'
      - $ref: '#/components/parameters/EQ_errorReason'
      - $ref: '#/components/parameters/EQ_correctiveEventID'
      - $ref: '#/components/parameters/orderBy'
      - $ref: '#/components/parameters/orderDirection'
      - $ref: '#/components/parameters/eventCountLimit'
      - $ref: '#/components/parameters/maxEventCount'
      - $ref: '#/components/parameters/GE_startTime'
      - $ref: '#/components/parameters/LT_startTime'
      - $ref: '#/components/parameters/GE_endTime'
      - $ref: '#/components/parameters/LT_endTime'
      - $ref: '#/components/parameters/EQ_type'
      - $ref: '#/components/parameters/EQ_deviceID'
      - $ref: '#/components/parameters/EQ_dataProcessingMethod'
      - $ref: '#/components/parameters/EQ_microorganism'
      - $ref: '#/components/parameters/EQ_chemicalSubstance'
      - $ref: '#/components/parameters/EQ_bizRules'
      - $ref: '#/components/parameters/EQ_stringValue'
      - $ref: '#/components/parameters/EQ_hexBinaryValue'
      - $ref: '#/components/parameters/EQ_uriValue'
      - $ref: '#/components/parameters/EQ_booleanValue'
      description: 'This endpoint returns all EPCIS events of a specific EPCIS event type up to the amount defined in `perPage`.

        The server returns a ''Link'' header to point to the remaining results.

        The client can further restrict the list of events returned by filtering events using the EPCIS query

        language using URL query string parameters as specified by the EPCIS Query Language.

        The parameter `eventCountLimit` is used to restrict the maximum number of

        events to be returned in total, whereas `perPage` restricts the number of events to return per page or paginated results.

        Example:

        ```

        https://example.com/eventTypes/ObjectEvent/events?EQ_bizStep=shipping%7Cdecommissioning&GE_eventTime=2015-03-15T00%3A00%3A00.000-04%3A00

        ```

        An EPCIS 2.0 query may also be expressed via parameters in the URI query string.  The query parameters with fixed fieldnames are included in this OpenAPI interface.  However, this list is not exhaustive and the EPCIS 2.0 standard defines additional query parameters with flexible names, depending on the specific value of `uom`, `type` or `fieldname` that appears within the name of the parameter.

        '
      responses:
        '200':
          $ref: '#/components/responses/200EPCISQueryDocument'
        '400':
          $ref: '#/components/responses/400QueryIssues'
        '401':
          $ref: '#/components/responses/401UnauthorizedRequest'
        '403':
          $ref: '#/components/responses/403ClientUnauthorized'
        '404':
          $ref: '#/components/responses/404ResourceNotFound'
        '406':
          $ref: '#/components/responses/406NotAcceptable'
        '414':
          $ref: '#/components/responses/414URLTooLong'
        '500':
          $ref: '#/components/responses/500ImplementationException'
  /epcs/{epc}/events:
    parameters:
    - $ref: '#/components/parameters/EPC'
    - $ref: '#/components/parameters/GS1-Extensions'
    get:
      tags:
      - Events
      summary: Returns EPCIS events matching the specified electronic product code.
      parameters:
      - $ref: '#/components/parameters/NextPageToken'
      - $ref: '#/components/parameters/PerPage'
      - $ref: '#/components/parameters/GS1-CBV-Min'
      - $ref: '#/components/parameters/GS1-CBV-Max'
      - $ref: '#/components/parameters/GS1-EPCIS-Min'
      - $ref: '#/components/parameters/GS1-EPCIS-Max'
      - $ref: '#/components/parameters/GS1-EPC-Format'
      - $ref: '#/components/parameters/GS1-CBV-XML-Format'
      - $ref: '#/components/parameters/eventType'
      - $ref: '#/components/parameters/GE_eventTime'
      - $ref: '#/components/parameters/LT_eventTime'
      - $ref: '#/components/parameters/GE_recordTime'
      - $ref: '#/components/parameters/LT_recordTime'
      - $ref: '#/components/parameters/EQ_action'
      - $ref: '#/components/parameters/EQ_bizStep'
      - $ref: '#/components/parameters/EQ_disposition'
      - $ref: '#/components/parameters/EQ_persistentDisposition_set'
      - $ref: '#/components/parameters/EQ_persistentDisposition_unset'
      - $ref: '#/components/parameters/EQ_readPoint'
      - $ref: '#/components/parameters/WD_readPoint'
      - $ref: '#/components/parameters/EQ_bizLocation'
      - $ref: '#/components/parameters/WD_bizLocation'
      - $ref: '#/components/parameters/EQ_transformationID'
      - $ref: '#/components/parameters/MATCH_epc'
      - $ref: '#/components/parameters/MATCH_parentID'
      - $ref: '#/components/parameters/MATCH_inputEPC'
      - $ref: '#/components/parameters/MATCH_outputEPC'
      - $ref: '#/components/parameters/MATCH_epcClass'
      - $ref: '#/components/parameters/MATCH_inputEPCClass'
      - $ref: '#/components/parameters/MATCH_outputEPCClass'
      - $ref: '#/components/parameters/MATCH_anyEPCClass'
      - $ref: '#/components/parameters/EQ_quantity'
      - $ref: '#/components/parameters/GT_quantity'
      - $ref: '#/components/parameters/GE_quantity'
      - $ref: '#/components/parameters/LT_quantity'
      - $ref: '#/components/parameters/LE_quantity'
      - $ref: '#/components/parameters/EQ_eventID'
      - $ref: '#/components/parameters/EXISTS_errorDeclaration'
      - $ref: '#/components/parameters/GE_errorDeclarationTime'
      - $ref: '#/components/parameters/LT_errorDeclarationTime'
      - $ref: '#/components/parameters/EQ_errorReason'
      - $ref: '#/components/parameters/EQ_correctiveEventID'
      - $ref: '#/components/parameters/orderBy'
      - $ref: '#/components/parameters/orderDirection'
      - $ref: '#/components/parameters/eventCountLimit'
      - $ref: '#/components/parameters/maxEventCount'
      - $ref: '#/components/parameters/GE_startTime'
      - $ref: '#/components/parameters/LT_startTime'
      - $ref: '#/components/parameters/GE_endTime'
      - $ref: '#/components/parameters/LT_endTime'
      - $ref: '#/components/parameters/EQ_type'
      - $ref: '#/components/parameters/EQ_deviceID'
      - $ref: '#/components/parameters/EQ_dataProcessingMethod'
      - $ref: '#/components/parameters/EQ_microorganism'
      - $ref: '#/components/parameters/EQ_chemicalSubstance'
      - $ref: '#/components/parameters/EQ_bizRules'
      - $ref: '#/components/parameters/EQ_stringValue'
      - $ref: '#/components/parameters/EQ_hexBinaryValue'
      - $ref: '#/components/parameters/EQ_uriValue'
      - $ref: '#/components/parameters/EQ_booleanValue'
      description: 'This endpoint helps to navigate EPCIS events by electronic product codes. It returns

        EPCIS events up to the amount defined in `perPage`. If applicable, the server returns a `Link` header to point to the remaining

        results. Optionally, EPCIS events can be further filtered using the EPCIS Query Language as query string parameters.

        Example 1 - EPC in a URN form with EPCIS Query Language filtering

        ```

        https://example.com/epcs/urn:epc:id:sgtin:0614141.107346.2018?EQ_bizStep=shipping%7Cdecommissioning&GE_eventTime=2015-03-15T00%3A00%3A00.000-04%3A00

        ```


        Example 2  - EPC in a constrained GS1 Digital Link form (URL encoded)

        ```

        https://example.com/epcs/https:%2f%2fexample.org%2f01%2f1234567089012400

        ```

        An EPCIS 2.0 query may also be expressed via the URI query string.  The query parameters with fixed fieldnames are included in this OpenAPI interface.  However, this list is not exhaustive and the EPCIS 2.0 standard defines additional query parameters with flexible names, depending on the specific value of `uom`, `type` or `fieldname` that appears within the name of the parameter.

        '
      responses:
        '200':
          $ref: '#/components/responses/200EPCISQueryDocument'
        '400':
          $ref: '#/components/responses/400QueryIssues'
        '401':
          $ref: '#/components/responses/401UnauthorizedRequest'
        '403':
          $ref: '#/components/responses/403ClientUnauthorized'
        '404':
          $ref: '#/components/responses/404ResourceNotFound'
        '406':
          $ref: '#/components/responses/406NotAcceptable'
        '414':
          $ref: '#/components/responses/414URLTooLong'
        '500':
          $ref: '#/components/responses/500ImplementationException'
  /bizSteps/{bizStep}/events:
    parameters:
    - $ref: '#/components/parameters/BizStep'
    - $ref: '#/components/parameters/GS1-Extensions'
    get:
      tags:
      - Events
      summary: Returns all EPCIS events related to the business step.
      parameters:
      - $ref: '#/components/parameters/NextPageToken'
      - $ref: '#/components/parameters/PerPage'
      - $ref: '#/components/parameters/GS1-CBV-Min'
      - $ref: '#/components/parameters/GS1-CBV-Max'
      - $ref: '#/components/parameters/GS1-EPCIS-Min'
      - $ref: '#/components/parameters/GS1-EPCIS-Max'
      - $ref: '#/components/parameters/GS1-EPC-Format'
      - $ref: '#/components/parameters/GS1-CBV-XML-Format'
      - $ref: '#/components/parameters/eventType'
      - $ref: '#/components/parameters/GE_eventTime'
      - $ref: '#/components/parameters/LT_eventTime'
      - $ref: '#/components/parameters/GE_recordTime'
      - $ref: '#/components/parameters/LT_recordTime'
      - $ref: '#/components/parameters/EQ_action'
      - $ref: '#/components/parameters/EQ_disposition'
      - $ref: '#/components/parameters/EQ_persistentDisposition_set'
      - $ref: '#/components/parameters/EQ_persistentDisposition_unset'
      - $ref: '#/components/parameters/EQ_readPoint'
      - $ref: '#/components/parameters/WD_readPoint'
      - $ref: '#/components/parameters/EQ_bizLocation'
      - $ref: '#/components/parameters/WD_bizLocation'
      - $ref: '#/components/parameters/EQ_transformationID'
      - $ref: '#/components/parameters/MATCH_epc'
      - $ref: '#/components/parameters/MATCH_parentID'
      - $ref: '#/components/parameters/MATCH_inputEPC'
      - $ref: '#/components/parameters/MATCH_outputEPC'
      - $ref: '#/components/parameters/MATCH_anyEPC'
      - $ref: '#/components/parameters/MATCH_epcClass'
      - $ref: '#/components/parameters/MATCH_inputEPCClass'
      - $ref: '#/components/parameters/MATCH_outputEPCClass'
      - $ref: '#/components/parameters/MATCH_anyEPCClass'
      - $ref: '#/components/parameters/EQ_quantity'
      - $ref: '#/components/parameters/GT_quantity'
      - $ref: '#/components/parameters/GE_quantity'
      - $ref: '#/components/parameters/LT_quantity'
      - $ref: '#/components/parameters/LE_quantity'
      - $ref: '#/components/parameters/EQ_eventID'
      - $ref: '#/components/parameters/EXISTS_errorDeclaration'
      - $ref: '#/components/parameters/GE_errorDeclarationTime'
      - $ref: '#/components/parameters/LT_errorDeclarationTime'
      - $ref: '#/components/parameters/EQ_errorReason'
      - $ref: '#/components/parameters/EQ_correctiveEventID'
      - $ref: '#/components/parameters/orderBy'
      - $ref: '#/components/parameters/orderDirection'
      - $ref: '#/components/parameters/eventCountLimit'
      - $ref: '#/components/parameters/maxEventCount'
      - $ref: '#/components/parameters/GE_startTime'
      - $ref: '#/components/parameters/LT_startTime'
      - $ref: '#/components/parameters/GE_endTime'
      - $ref: '#/components/parameters/LT_endTime'
      - $ref: '#/components/parameters/EQ_type'
      - $ref: '#/components/parameters/EQ_deviceID'
      - $ref: '#/components/parameters/EQ_dataProcessingMethod'
      - $ref: '#/components/parameters/EQ_microorganism'
      - $ref: '#/components/parameters/EQ_chemicalSubstance'
      - $ref: '#/components/parameters/EQ_bizRules'
      - $ref: '#/components/parameters/EQ_stringValue'
      - $ref: '#/components/parameters/EQ_hexBinaryValue'
      - $ref: '#/components/parameters/EQ_uriValue'
      - $ref: '#/components/parameters/EQ_booleanValue'
      description: 'This endpoint helps to navigate EPCIS events by business steps. It returns

        EPCIS events up to the amount defined in `perPage`. The server returns a `Link` header to point to the

        remaining results.  Optionally, EPCIS events can be further filtered using the EPCIS Query Language in as query

        string parameters.

        Example:

        ```

        https://example.com/bizSteps/receiving?GE_eventTime=2015-03-15T00%3A00%3A00.000-04%3A00

        ```

        An EPCIS 2.0 query may also be expressed via the URI query string.  The query parameters with fixed fieldnames are included in this OpenAPI interface.  However, this list is not exhaustive and the EPCIS 2.0 standard defines additional query parameters with flexible names, depending on the specific value of `uom`, `type` or `fieldname` that appears within the name of the parameter.

        '
      responses:
        '200':
          $ref: '#/components/responses/200EPCISQueryDocument'
        '400':
          $ref: '#/components/responses/400QueryIssues'
        '401':
          $ref: '#/components/responses/401UnauthorizedRequest'
        '403':
          $ref: '#/components/responses/403ClientUnauthorized'
        '404':
          $ref: '#/components/responses/404ResourceNotFound'
        '406':
          $ref: '#/components/responses/406NotAcceptable'
        '414':
          $ref: '#/components/responses/414URLTooLong'
        '500':
          $ref: '#/components/responses/500ImplementationException'
  /bizLocations/{bizLocation}/events:
    parameters:
    - $ref: '#/components/parameters/BizLocation'
    - $ref: '#/components/parameters/GS1-Extensions'
    get:
      tags:
      - Events
      summary: Returns all EPCIS events related to the business location.
      parameters:
      - $ref: '#/components/parameters/NextPageToken'
      - $ref: '#/components/parameters/PerPage'
      - $ref: '#/components/parameters/GS1-CBV-Min'
      - $ref: '#/components/parameters/GS1-CBV-Max'
      - $ref: '#/components/parameters/GS1-EPCIS-Min'
      - $ref: '#/components/parameters/GS1-EPCIS-Max'
      - $ref: '#/components/parameters/GS1-EPC-Format'
      - $ref: '#/components/parameters/GS1-CBV-XML-Format'
      - $ref: '#/components/parameters/eventType'
      - $ref: '#/components/parameters/GE_eventTime'
      - $ref: '#/components/parameters/LT_eventTime'
      - $ref: '#/components/parameters/GE_recordTime'
      - $ref: '#/components/parameters/LT_recordTime'
      - $ref: '#/components/parameters/EQ_action'
      - $ref: '#/components/parameters/EQ_bizStep'
      - $ref: '#/components/parameters/EQ_disposition'
      - $ref: '#/components/parameters/EQ_persistentDisposition_set'
      - $ref: '#/components/parameters/EQ_persistentDisposition_unset'
      - $ref: '#/components/parameters/EQ_readPoint'
      - $ref: '#/components/parameters/WD_readPoint'
      - $ref: '#/components/parameters/WD_bizLocation'
      - $ref: '#/components/parameters/EQ_transformationID'
      - $ref: '#/components/parameters/MATCH_epc'
      - $ref: '#/components/parameters/MATCH_parentID'
      - $ref: '#/components/parameters/MATCH_inputEPC'
      - $ref: '#/components/parameters/MATCH_outputEPC'
      - $ref: '#/components/parameters/MATCH_anyEPC'
      - $ref: '#/components/parameters/MATCH_epcClass'
      - $ref: '#/components/parameters/MATCH_inputEPCClass'
      - $ref: '#/components/parameters/MATCH_outputEPCClass'
      - $ref: '#/components/parameters/MATCH_anyEPCClass'
      - $ref: '#/components/parameters/EQ_quantity'
      - $ref: '#/components/parameters/GT_quantity'
      - $ref: '#/components/parameters/GE_quantity'
      - $ref: '#/components/parameters/LT_quantity'
      - $ref: '#/components/parameters/LE_quantity'
      - $ref: '#/components/parameters/EQ_eventID'
      - $ref: '#/components/parameters/EXISTS_errorDeclaration'
      - $ref: '#/components/parameters/GE_errorDeclarationTime'
      - $ref: '#/components/parameters/LT_errorDeclarationTime'
      - $ref: '#/components/parameters/EQ_errorReason'
      - $ref: '#/components/parameters/EQ_correctiveEventID'
      - $ref: '#/components/parameters/orderBy'
      - $ref: '#/components/parameters/orderDirection'
      - $ref: '#/components/parameters/eventCountLimit'
      - $ref: '#/components/parameters/maxEventCount'
      - $ref: '#/components/parameters/GE_startTime'
      - $ref: '#/components/parameters/LT_startTime'
      - $ref: '#/components/parameters/GE_endTime'
      - $ref: '#/components/parameters/LT_endTime'
      - $ref: '#/components/parameters/EQ_type'
      - $ref: '#/components/parameters/EQ_deviceID'
      - $ref: '#/components/parameters/EQ_dataProcessingMethod'
      - $ref: '#/components/parameters/EQ_microorganism'
      - $ref: '#/components/parameters/EQ_chemicalSubstance'
      - $ref: '#/components/parameters/EQ_bizRules'
      - $ref: '#/components/parameters/EQ_stringValue'
      - $ref: '#/components/parameters/EQ_hexBinaryValue'
      - $ref: '#/components/parameters/EQ_uriValue'
      - $ref: '#/components/parameters/EQ_booleanValue'
      description: 'This endpoint helps to navigate EPCIS events by business locations. It returns

        EPCIS events up to the amount defined in `perPage`. The server returns a `Link` header to point to the remaining

        results.

        Optionally, EPCIS events can be further filtered using the EPCIS Query Language as query string parameters.

        Example:

        ```

        https://example.com/bizLocations/urn:epc:id:sgln:0012345.11111.400?GE_eventTime=2015-03-15T00%3A00%3A00.000-04%3A00

        ```

        An EPCIS 2.0 query may also be expressed via the URI query string.  The query parameters with fixed fieldnames are included in this OpenAPI interface.  However, this list is not exhaustive and the EPCIS 2.0 standard defines additional query parameters with flexible names, depending on the specific value of `uom`, `type` or `fieldname` that appears within the name of the parameter.

        '
      responses:
        '200':
          $ref: '#/components/responses/200EPCISQueryDocument'
        '400':
          $ref: '#/components/responses/400QueryIssues'
        '401':
          $ref: '#/components/responses/401UnauthorizedRequest'
        '403':
          $ref: '#/components/responses/403ClientUnauthorized'
        '404':
          $ref: '#/components/responses/404ResourceNotFound'
        '406':
          $ref: '#/components/responses/406NotAcceptable'
        '414':
          $ref: '#/components/responses/414URLTooLong'
        '500':
          $ref: '#/components/responses/500ImplementationException'
  /readPoints/{readPoint}/events:
    parameters:
    - $ref: '#/components/parameters/ReadPoint'
    - $ref: '#/components/parameters/GS1-Extensions'
    get:
      tags:
      - Events
      summary: Returns all EPCIS events related to the read point.
      parameters:
      - $ref: '#/components/parameters/NextPageToken'
      - $ref: '#/components/parameters/PerPage'
      - $ref: '#/components/parameters/GS1-CBV-Min'
      - $ref: '#/components/parameters/GS1-CBV-Max'
      - $ref: '#/components/parameters/GS1-EPCIS-Min'
      - $ref: '#/components/parameters/GS1-EPCIS-Max'
      - $ref: '#/components/parameters/GS1-EPC-Format'
      - $ref: '#/components/parameters/GS1-CBV-XML-Format'
      - $ref: '#/components/parameters/eventType'
      - $ref: '#/components/parameters/GE_eventTime'
      - $ref: '#/components/parameters/LT_eventTime'
      - $ref: '#/components/parameters/GE_recordTime'
      - $ref: '#/components/parameters/LT_recordTime'
      - $ref: '#/components/parameters/EQ_action'
      - $ref: '#/components/parameters/EQ_bizStep'
      - $ref: '#/components/parameters/EQ_disposition'
      - $ref: '#/components/parameters/EQ_persistentDisposition_set'
      - $ref: '#/components/parameters/EQ_persistentDisposition_unset'
      - $ref: '#/components/parameters/WD_readPoint'
      - $ref: '#/components/parameters/EQ_bizLocation'
      - $ref: '#/components/parameters/WD_bizLocation'
      - $ref: '#/components/parameters/EQ_transformationID'
      - $ref: '#/components/parameters/MATCH_epc'
      - $ref: '#/components/parameters/MATCH_parentID'
      - $ref: '#/components/parameters/MATCH_inputEPC'
      - $ref: '#/components/parameters/MATCH_outputEPC'
      - $ref: '#/components/parameters/MATCH_anyEPC'
      - $ref: '#/components/parameters/MATCH_epcClass'
      - $ref: '#/components/parameters/MATCH_inputEPCClass'
      - $ref: '#/components/parameters/MATCH_outputEPCClass'
      - $ref: '#/components/parameters/MATCH_anyEPCClass'
      - $ref: '#/components/parameters/EQ_quantity'
      - $ref: '#/components/parameters/GT_quantity'
      - $ref: '#/components/parameters/GE_quantity'
      - $ref: '#/components/parameters/LT_quantity'
      - $ref: '#/components/parameters/LE_quantity'
      - $ref: '#/components/parameters/EQ_eventID'
      - $ref: '#/components/parameters/EXISTS_errorDeclaration'
      - $ref: '#/components/parameters/GE_errorDeclarationTime'
      - $ref: '#/components/parameters/LT_errorDeclarationTime'
      - $ref: '#/components/parameters/EQ_errorReason'
      - $ref: '#/components/parameters/EQ_correctiveEventID'
      - $ref: '#/components/parameters/orderBy'
      - $ref: '#/components/parameters/orderDirection'
      - $ref: '#/components/parameters/eventCountLimit'
      - $ref: '#/components/parameters/maxEventCount'
      - $ref: '#/components/parameters/GE_startTime'
      - $ref: '#/components/parameters/LT_startTime'
      - $ref: '#/components/parameters/GE_endTime'
      - $ref: '#/components/parameters/LT_endTime'
      - $ref: '#/components/parameters/EQ_type'
      - $ref: '#/components/parameters/EQ_deviceID'
      - $ref: '#/components/parameters/EQ_dataProcessingMethod'
      - $ref: '#/components/parameters/EQ_microorganism'
      - $ref: '#/components/parameters/EQ_chemicalSubstance'
      - $ref: '#/components/parameters/EQ_bizRules'
      - $ref: '#/components/parameters/EQ_stringValue'
      - $ref: '#/components/parameters/EQ_hexBinaryValue'
      - $ref: '#/components/parameters/EQ_uriValue'
      - $ref: '#/components/parameters/EQ_booleanValue'
      description: 'This endpoint helps to navigate EPCIS events by read points. It returns

        EPCIS events up to the amount defined in `perPage`. The server returns a `Link` header to point to the remaining

        results.

        Optionally, EPCIS events can be further filtered using the EPCIS Query Language as query string parameters.

        Example:

        ```

        https://example.com/readPoints/urn:epc:id:sgln:0012345.11111.400?GE_eventTime=2015-03-15T00%3A00%3A00.000-04%3A00

        ```

        An EPCIS 2.0 query may also be expressed via the URI query string.  The query parameters with fixed fieldnames are included in this OpenAPI interface.  However, this list is not exhaustive and the EPCIS 2.0 standard defines additional query parameters with flexible names, depending on the specific value of `uom`, `type` or `fieldname` that appears within the name of the parameter.

        '
      responses:
        '200':
          $ref: '#/components/responses/200EPCISQueryDocument'
        '400':
          $ref: '#/components/responses/400QueryIssues'
        '401':
          $ref: '#/components/responses/401UnauthorizedRequest'
        '403':
          $ref: '#/components/responses/403ClientUnauthorized'
        '404':
          $ref: '#/components/responses/404ResourceNotFound'
        '406':
          $ref: '#/components/responses/406NotAcceptable'
        '414':
          $ref: '#/components/responses/414URLTooLong'
        '500':
          $ref: '#/components/responses/500ImplementationException'
  /dispositions/{disposition}/

# --- truncated at 32 KB (141 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/gs1/refs/heads/main/openapi/gs1-events-api-openapi.yml