# Events

Events allow you to receive updates about prescriptions as they move through the dispensing process.

When an important part of the dispensing process happens for a prescription, we publish an `Event` to the event feed if there is a `Subscription` record with matching demographic and prescription information (termed `PrescriptionIdentity`). You don't need to worry about creating subscriptions if you use our Intake API to send prescriptions to Gifthealth. We automatically create subscriptions for you.

The events endpoint is stateless, and assumes a single consumer. Events are not removed from the events endpoint when they are read.

Events currently remain visible in the events endpoint indefinitely, but this may change in the future. Design your system with the understanding that event availability has a limited timeframe.

You are responsible for tracking the `iterator` value as you process items from the queue. You can replay events as needed by resetting the `iterator` value to an earlier value.


## Get all events

 - [GET /events](https://docs.gifthealth.com/intake-api/openapi/events/getevents.md)

## Get an event

 - [GET /events/{id}](https://docs.gifthealth.com/intake-api/openapi/events/getevent.md)