Skip to content

Add start_time and end_time as query parameters to the Events API #107

Closed

Description

@michael-danko-passport

Is your feature request related to a problem? Please describe.

One of the issues outlined within #99 is that the Events API requires API consumers to deduplicate the events received and compare against already ingested data. This may become increasingly complicated as the volume of events within a provider's system grows.

Describe the solution you'd like

Add additional query parameters to the API specification that will enable an API consumer to designate the time window of when they would like to search for events.

Is this a breaking change

This could be a breaking change if this was made as a query parameter that was required to be implemented.

Impacted Spec

  • Events

Additional context

If this was not implemented as a required parameter, there may be technical concerns about source systems not being able to respond with the necessary data in an open ended query.

This may help alleviate some, but not all, of the concerns raised in #99.

Activity

  1. added this to the 1.1 milestone on May 30, 2023
  2. jiffyclub commented on Aug 20, 2024

    @jiffyclub
    Contributor

    Another option that I think would work pretty well would be to use the event_time=YYYY-MM-DDTHH convention that MDS uses to get an hour's worth of data at a time.

  3. ArchaicDebugger commented on Oct 10, 2024

    @ArchaicDebugger
    Contributor

    +1 for this, sometimes it's essential to do some sort of limitation to the consumers, or assist them in picking up events for a certain date they would like to, instead of having them do guesswork about which page they should pick up to compensate for a certain date. This combined with pagination should be very helpful for consumers, as well as certain implementation models that benefit from having a date range filter for better performance.

    I'd also like to bring up that pagination is not a requirement and in those cases asking for events will return a whole dataset which not only would be impactful on the provider, but also hit the consumer with a huge JSON response.

  4. schnuerle commented on Apr 18, 2025

    @schnuerle
    Member

    A proposal in a PR is needed to move this forward.

  5. jiffyclub commented on Apr 22, 2025

    @jiffyclub
    Contributor

    See #140 as one option.

  6. schnuerle commented on Jul 15, 2025

    @schnuerle
    Member

    Closed with #140.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions