---
title: "Get subscription events"
method: GET
path: "/api/v1/hooks/subscriptions/{subscription_id}/events/"
tags: ["webhooks"]
---

# Get subscription events

`GET /api/v1/hooks/subscriptions/{subscription_id}/events/`

Get all of the events that have triggered for the given subscription.

## Path parameters

- `subscription_id` string, required

## Query parameters

- `offset` integer
- `limit` integer
- `status` string
- `resource_id` string

## Headers

- `Authorization` string, required

## Response `200`

Retrieved

- SubscriptionEventList
  - `results` SubscriptionEvent[], required — All the events triggered for the subscription
    - `id` string — The ID of the subscription event.
    - `datetime_created` string — The time the event was created.
    - `datetime_updated` string — The last time the event was updated.
    - `event_type` string — The event type that was triggered.
    - `resource_id` string — The Prolific Resource ID that the event is linked to.
    - `status` 'PENDING' | 'SUCCEEDED' | 'FAILED' — The status of the event. Will be `FAILED` if the `target_url` response is not 2xx.
    - `target_url` string — The URL where the event payload is sent.
    - `payload` SubscriptionEventPayload — The event payload that was sent to the target url.

## Other responses

- `400` — Error

---

[API](https://skmtc.net/prolific/apis/api-reference.md) · [All operations](https://skmtc.net/prolific/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prolific/api-reference/versions/5c53371c41a0/schema)