# Gets a list of deadletters for a container.

Endpoint: GET /api/failed-events
Version: v1
Security: authorization_code_dev, client_credentials_dev, authorization_code, client_credentials

## Query parameters:

  - `subscriptionName` (string)
    If specified restricts result to a specific subscription.

  - `pageSize` (integer)
    Divides the result into pages. (Default = 10, max = 100, min = 1)

  - `cursor` (integer)
    Reference for next page.

  - `fromDate` (string)
    If specified restricts result to a time period newer than this value.

  - `toDate` (string)
    If specified restricts result to a time period older than this value.

## Header parameters:

  - `ResourceUri` (string)
    ResourceUri to create the event subscriptions under.

  - `TenantId` (string)
    TenantId used by the customer.

## Response 200 fields (text/plain):

  - `data` (array,null)
    A list of failed events.

  - `data.deadletterId` (string,null)
    The id of the deadletter.

  - `data.subscriptionName` (string,null)
    The name of the subcription the event was sent to.

  - `data.topic` (string,null)
    The topic this deadletter belongs to.

  - `data.createdOn` (string)
    When the deadletter was created.

  - `data.sizeInBytes` (integer)
    The size of the deadletter file.

  - `pageSize` (integer)
    The max number of items per page.

  - `cursor` (integer,null)
    A reference for the next page.

## Response 400 fields (text/plain):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)

## Response 404 fields (text/plain):

  - `type` (string,null)

  - `title` (string,null)

  - `status` (integer,null)

  - `detail` (string,null)

  - `instance` (string,null)