Lithic API Documentation | Events › Subscriptions › List Message Attempts For An Event Subscription

API Reference

Events

events

Methods

List Events -> CursorPage<

Event

get/v1/events

List all events.

Get Event ->

Event

get/v1/events/{event_token}

Get an event.

List Message Attempts For An Event -> CursorPage<

MessageAttempt

get/v1/events/{event_token}/attempts

List all the message attempts for a given event.

Domain types

Event = { token, created, event_type, 1 more... }

A single event that affects the transaction state and lifecycle.

EventSubscription = { token, description, disabled, 2 more... }

A subscription to specific event types.

MessageAttempt = { token, created, event_subscription_token, 5 more... }

A subscription to specific event types.

Events

Event Subscriptions

events.event_subscriptions

Methods

Resend Event ->

post/v1/events/{event_token}/event_subscriptions/{event_subscription_token}/resend

Resend an event to an event subscription.

Events

Subscriptions

events.subscriptions

Methods

List Event Subscriptions -> CursorPage<

EventSubscription

get/v1/event_subscriptions

List all the event subscriptions.

query Parameters

ending_before: string

Optional

A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this item.

page_size: number

Optional

(maximum: 100, minimum: 1, default: 50)

Page size (for pagination).

starting_after: string

Optional

A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item.

Response fields

data: Array<

EventSubscription

has_more: boolean

Request example

curl https://api.lithic.com/v1/event_subscriptions \
    -H "Authorization: $LITHIC_API_KEY"

200Example

{
  "data": [
    {
      "token": "ep_1srOrx2ZWZBpBUvZwXKQmoEYga1",
      "description": "description",
      "disabled": true,
      "url": "https://example.com",
      "event_types": [
        "account_holder_document.updated"
      ]
    }
  ],
  "has_more": true
}

Create Event Subscription ->

EventSubscription

post/v1/event_subscriptions

Create a new event subscription.

Get Event Subscription ->

EventSubscription

get/v1/event_subscriptions/{event_subscription_token}

Get an event subscription.

Update Event Subscription ->

EventSubscription

patch/v1/event_subscriptions/{event_subscription_token}

Update an event subscription.

Delete Event Subscription ->

delete/v1/event_subscriptions/{event_subscription_token}

Delete an event subscription.

Resend Failed Messages ->

post/v1/event_subscriptions/{event_subscription_token}/recover

Resend all failed messages since a given time.

List Message Attempts For An Event Subscription -> CursorPage<

MessageAttempt

get/v1/event_subscriptions/{event_subscription_token}/attempts

List all the message attempts for a given event subscription.

path Parameters

event_subscription_token: string

query Parameters

begin: string

Optional

(format: date-time)

Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone.

end: string

Optional

(format: date-time)

Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone.

ending_before: string

Optional

A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this item.

page_size: number

Optional

(maximum: 100, minimum: 1, default: 50)

Page size (for pagination).

starting_after: string

Optional

A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item.

status:

Optional

"FAILED"

"PENDING"

"SENDING"

"SUCCESS"

Response fields

data: Array<

MessageAttempt

has_more: boolean

Request example

curl https://api.lithic.com/v1/event_subscriptions/$EVENT_SUBSCRIPTION_TOKEN/attempts \
    -H "Authorization: $LITHIC_API_KEY"

200Example

{
  "data": [
    {
      "token": "atmpt_1srOrx2ZWZBpBUvZwXKQmoEYga2",
      "created": "2019-12-27T18:11:19.117Z",
      "event_subscription_token": "ep_1srOrx2ZWZBpBUvZwXKQmoEYga1",
      "event_token": "msg_1srOrx2ZWZBpBUvZwXKQmoEYga1",
      "response": "response",
      "response_status_code": 0,
      "status": "FAILED",
      "url": "https://example.com"
    }
  ],
  "has_more": true
}

Replay Missing Messages ->

post/v1/event_subscriptions/{event_subscription_token}/replay_missing

Replays messages to the endpoint. Only messages that were created after begin will be sent. Messages that were previously sent to the endpoint are not resent. Message will be retried if endpoint responds with a non-2xx status code. See Retry Schedule for details.

Get Event Subscription Secret -> { secret }

get/v1/event_subscriptions/{event_subscription_token}/secret

Get the secret for an event subscription.

Rotate Event Subscription Secret ->

post/v1/event_subscriptions/{event_subscription_token}/secret/rotate

Rotate the secret for an event subscription. The previous secret will be valid for the next 24 hours.

Send Event Type Example Message ->

post/v1/simulate/event_subscriptions/{event_subscription_token}/send_example

Send an example message for event.