Webhook Events - List

Lista eventos de domínio (notificações geradas) e metadados para reenvio ou suporte.

Authorization

SelectKeyAuth

selectkey<token>

API key for all authenticated requests. Send your key in the selectkey header (e.g. sandbox sl_test_…, production sl_live_…).

In: header

Query Parameters

limit?number

Maximum number of items to return

offset?number

Number of items to skip

sort?string

Sort order for results

status?string

Filter by delivery status

type?string

Filter by event type

eventid?string

Filter by event ID

resource?string

Filter by resource kind

resourceid?string

Filter by resource public ID

endpoint?string

Filter by target endpoint URL substring

daterange?string

Filter to a single calendar day; the API expands this to the start and end of that day for the relevant timestamp field.

daterangegt?string

Lower bound (exclusive): include only records whose date field is strictly after this value.

daterangegte?string

Lower bound (inclusive): include only records whose date field is on or after this value.

daterangelt?string

Upper bound (exclusive): include only records whose date field is strictly before this value.

daterangelte?string

Upper bound (inclusive): include only records whose date field is on or before this value.

Response Body

`application/json`

curl -X GET "https://example.com/v1/webhooks/events?limit=20&offset=0&sort=descending&status=delivered&type=transaction.approved&eventid=evt_abc123&resource=transaction&resourceid=tra_abc123&endpoint=Example+text&daterange=2026-01-01T00%3A00%3A00Z&daterangegt=2026-01-01T00%3A00%3A00Z&daterangegte=2026-01-01T00%3A00%3A00Z&daterangelt=2026-01-01T00%3A00%3A00Z&daterangelte=2026-01-01T00%3A00%3A00Z"

{
  "offset": 0,
  "limit": 20,
  "total": 100,
  "hasMore": true,
  "page": {
    "current": 1,
    "total": 5,
    "offset": {
      "first": 0,
      "prev": 0,
      "next": 20,
      "last": 80
    }
  },
  "data": [
    {
      "id": "wbh_01hqzvabc",
      "resource": "transaction",
      "type": "transaction.approved",
      "attempts": 1,
      "lastAttempt": "2026-04-12T17:56:33.000Z",
      "description": "Transaction approved event",
      "requestPayload": {
        "id": "tra_987654321",
        "amount": 1500,
        "status": "approved"
      },
      "updatedAt": "2026-04-12T17:56:33.000Z",
      "createdAt": "2026-04-12T17:56:32.000Z",
      "source": "api",
      "dispatches": [
        {
          "id": "wdi_01hqzvabc",
          "status": "success",
          "endpoint": "https://webhooks.mydomain.com/selectwin",
          "attempts": 1,
          "lastAttemptAt": "2026-04-12T17:56:33.100Z",
          "successAt": "2026-04-12T17:56:33.150Z",
          "responseStatusCode": 200,
          "responseTime": 120,
          "responseBody": "OK",
          "correlationId": "corr_abc123",
          "updatedAt": "2026-04-12T17:56:33.150Z",
          "createdAt": "2026-04-12T17:56:33.000Z"
        }
      ]
    }
  ],
  "merchant": {
    "name": "Seller Name",
    "merchantId": "bus_1234567890",
    "isSubAccount": false
  },
  "_links": {
    "self": {
      "href": "https://api.selectwin.io/v1/webhooks/events",
      "method": "GET"
    }
  }
}

{
  "error": {
    "status": "Bad Request",
    "statusCode": 400,
    "category": "validation",
    "message": "Validation errors occurred",
    "details": "One or more parameters are invalid or out of range. Please check the parameters and try again.",
    "params": [
      {
        "payment[currency]": "currency must be one of [BRL]"
      },
      {
        "amount": "amount is required"
      }
    ],
    "code": "invalidParameters",
    "resource": "client"
  }
}

{
  "error": {
    "status": "Unauthorized",
    "statusCode": 401,
    "category": "authentication",
    "message": "Unauthorized",
    "details": "Authentication failed. The provided API key is invalid or does not have permission to operate.",
    "code": "unauthorized"
  }
}

{
  "error": {
    "status": "Forbidden",
    "statusCode": 403,
    "category": "authorization",
    "message": "Forbidden",
    "details": "Access denied. This may be due to IP blocks, domain restrictions, or insufficient permissions.",
    "code": "forbidden"
  }
}

{
  "error": {
    "status": "Not Found",
    "statusCode": 404,
    "category": "client",
    "message": "Not Found",
    "details": "The requested resource was not found on the server.",
    "code": "notFound"
  }
}

{
  "error": {
    "status": "Unprocessable Entity",
    "statusCode": 422,
    "category": "validation",
    "message": "Unprocessable Entity",
    "details": "The request was understood, but contains invalid data that could not be processed.",
    "code": "unprocessableEntity"
  }
}

{
  "error": {
    "status": "Too Many Requests",
    "statusCode": 429,
    "category": "rate_limit",
    "message": "Too Many Requests",
    "details": "The number of requests exceeded the limit allowed for the IP or user.",
    "retryAfterMinutes": 60,
    "code": "tooManyRequests"
  }
}

{
  "error": {
    "status": "Internal Server Error",
    "statusCode": 500,
    "category": "server",
    "message": "Server error.",
    "details": "An internal server error occurred. Please try again later.",
    "code": "serverError",
    "resource": "server"
  }
}

Webhook Events - List

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`