# API Event Subscription Attempts

## Definitions

### Parameters

- **event_token**  
  *string*  
  *required*

- **status**  
  *string*  
  *enum*
  
  Allowed:
   
  `FAILED`, `PENDING`, `SENDING`, `SUCCESS`

- **begin**  
  *date-time*  
  Date string in RFC 3339 format (UTC time zone).

- **end**  
  *date-time*  
  Date string in RFC 3339 format (UTC time zone).

- **ending_before**  
  *string*  
  Cursor for pagination.

- **page_size**  
  *integer*  
  1 to 100. Defaults to 50.

- **starting_after**  
  *string*  
  Cursor for pagination.

## Response Codes

### `200 OK`

- **data**  
  *array of objects*  
  *required*

- **data**  
    *object*  
    A subscription to specific event types.
       
    - **created**  
      *date-time*  
      *required*
      
      An RFC 3339 timestamp for when the event was created (UTC time zone).

- **event_subscription_token**  
      *string*  
      *required*

- **event_token**  
      *string*  
      *required*

- **response**  
      *string*  
      *required*

- **response_status_code**  
      *integer*  
      *required*

- **status**  
      *string*  
      *enum*  
      *required*
      `FAILED`, `PENDING`, `SENDING`, `SUCCESS`

- **token**  
      *string*  
      *required*

- **url**  
      *uri*  
      *required*

- **has_more**  
      *boolean*  
      *required*

### Error Codes

- **400**  
  A parameter in the query is invalid.

- **401**  
  User has not been authenticated.

- **404**  
  Specified resource not found.

- **409**  
  Request could not be completed due to a conflict.

- **422**  
  Unprocessable entity.

- **429**  
  Client has exceeded the number of allowed requests.

## Example Curl Command

```shell
curl --request GET \
     --url 'https://sandbox.lithic.com/v1/events/event_token/attempts?page_size=50' \
     --header 'accept: application/json'
```

## Example Response

```json
{
  "data": [
    {
      "created": "2026-07-18T00:25:27.685Z",
      "event_subscription_token": "ep_1srOrx2ZWZBpBUvZwXKQmoEYga1",
      "event_token": "msg_1srOrx2ZWZBpBUvZwXKQmoEYga1",
      "response": "string",
      "response_status_code": 0,
      "status": "FAILED",
      "token": "atmpt_1srOrx2ZWZBpBUvZwXKQmoEYga2",
      "url": "string"
    }
  ],
  "has_more": true
}
```