Extract

List failedSubscription

GEThttps://example.thoughtindustries.com/incoming/v2/events/failedSubscription

Retrieves a paginated list of failedSubscription events. Each event represents a subscription payment failure. Filter results by date range, user, or notifiable resource.

Example request

curl "https://example.thoughtindustries.com/incoming/v2/events/failedSubscription" \
  -H 'Authorization: Bearer YOUR_API_KEY'

Parameters

Name	Type	Required	Location	Description
`kind`	`string`	No	query	Filters events by a specific kind or subtype.
`cursor`	`string`	No	query	Pagination cursor returned from a previous response; fetches the next page of results.
`startDate`	`ISO 8601 timestamp`	No	query	Returns only events that occurred on or after this ISO 8601 timestamp.
`endDate`	`ISO 8601 timestamp`	No	query	Returns only events that occurred on or before this ISO 8601 timestamp.
`notifiableId`	`uuid`	No	query	Filters events to those associated with the specified notifiable resource UUID.
`userId`	`uuid`	No	query	Filters events to those associated with the specified user UUID.

Example response

{
  "data": {
    "APIEvents": {
      "pageInfo": {
        "perPage": 0,
        "cursor": "string",
        "total": 0,
        "hasMore": true
      },
      "events": [
        {}
      ]
    }
  }
}

Response fields

Field	Type	Description
`pageInfo`	`CursorPageInfo`	Pagination metadata for the current result set.
`pageInfo.perPage`	`integer`	Number of events returned per page.
`pageInfo.cursor`	`string`	Opaque cursor value used to retrieve the next page of results.
`pageInfo.total`	`integer`	Total number of events matching the query.
`pageInfo.hasMore`	`boolean`	Indicates whether additional pages of results are available.
`events`	`object[]`	Array of `failedSubscription` event objects matching the query.