--- title: "List Webhooks" source_url: https://docs.rapyd.net/en/list-webhooks.html lang: en --- # List Webhooks Retrieve a list of all webhooks that were sent. You can filter the list with query parameters. ### Parameters ### Request Query Parameters - - from_created_at - The earliest date and time when the object was created, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds). - - limit - The maximum number of objects to return. Range: 1-20. 20 - - page - Page number for pagination. - - status - The status of the webhook. One of the following values: - **NEW** - The webhook was created and has not yet been sent successfully. - **RET** - The webhook was resent. - **CLO** - The webhook was sent successfully. - **ERR** - Attempts were made to send the webhook, but the maximum number of retries was reached. The automatic retry process failed. The webhook was not sent. - - type - The type of webhook. - - to_created_at - The latest date and time when the object was created, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds). ### Request Header Parameters - - access_key - Unique access key provided by Rapyd for each authorized user. See [Developers](https://docs.rapyd.net/en/developers.md "Developers"). - - Content-Type - Indicates that the data appears in JSON format. Set to **application/json**. - - salt - Random string. Recommended length: 8-16 characters. - - signature - Signature calculated for each request individually. See [Request Signatures](https://docs.rapyd.net/en/request-signatures.md "Request Signatures"). - - timestamp - Timestamp for the request, in [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time") (seconds). ### Response Parameters - - attempts - List of attempts at sending the webhook. Array of objects that contain the following fields: - - error - Error message received from the configured webhook destination. - - http_status_code - HTTP status code returned by the configured webhook destination. - - http_response_body - Body of the HTTP response from the configured webhook destination. - - http_response_headers - Headers of the HTTP response from the configured webhook destination, with the value received. - - connection - Control options for the connection. - - content-length - Length of the content in bytes. - - content-type - MIME type of the content. - - date - Timestamp of the response in HTTP-date format (RFC 9110). - - server - Name of the server. - - created_at - Timestamp for the creation of the webhook. [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - data - The `data` section of the webhook itself. - - last_attempt_at - Timestamp of the last attempt at sending the webhook. [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - next_attempt_at - Timestamp of the next attempt at sending the webhook. [Unix time](https://docs.rapyd.net/en/glossary.md#UUID-945d98cf-adae-e1cf-2606-c7fae8b4a7e1_unix_time "Unix time"). - - status - Status of the webhook. One of the following values: - **NEW** (new) - The webhook was created and has not yet been sent successfully. - **CLO** (closed) - The webhook was sent successfully. - **ERR** (error) - Attempts were made to send the webhook, but the maximum number of retries was reached. The automatic retry process failed. The webhook was not sent. - **RET** (retried) - The webhook was resent. > **Note:** > > Inside the `data` object, some webhooks have another `status` field that refers to a different event. - - token - ID of the webhook. String starting with **wh_**. - - type - Internal name of the webhook type. - /v1/webhooks - List Webhooks - ```curl curl -X get 'https://sandboxapi.rapyd.net/v1/webhooks?type=CARD_ADDED_SUCCESSFULLY&from_created_at=1762689112' \ -H 'access_key: your-access-key-here' \ -H 'Content-Type: application/json' \ -H 'salt: your-random-string-here' \ -H 'signature: your-calculated-signature-here' \ -H 'timestamp: your-unix-timestamp-here' ``` - ```json { "status": { "error_code": "", "status": "SUCCESS", "message": "", "response_code": "", "operation_id": "d1addc51-565f-49e1-8813-f013fa66ec96" }, "data": [ { "token": "wh_641d85ccab0dc07cb0cd3597aa25df05", "type": "CARD_ADDED_SUCCESSFULLY", "data": { "id": null, "type": "gb_amex_card", "category": "card", "metadata": {}, "image": "", "webhook_url": "", "supporting_documentation": "", "next_action": "3d_verification", "full_name": { "first_name": "John", "middle_name": "Johnson", "last_name": "Doe" }, "account_name_inquiry": { "account_name_inquiry_result": "not_performed", "account_name_inquiry_details": { "last_name": null, "first_name": null, "middle_name": null } }, "name": "John Doe", "last4": "1111", "acs_check": "unchecked", "cvv_check": "unchecked", "bin_details": { "type": "DEBIT", "brand": "VISA", "level": "CLASSIC", "issuer": "CONOTOXIA SP. Z O.O", "country": "PL", "bin_number": "411111" }, "expiration_year": "30", "expiration_month": "12", "fingerprint_token": "ocfp_e599f990674473ce6283b245e9ad2467", "network_reference_id": 941438, "payment_account_reference": "V0012EE8QZTYHJVNHT4L2FOZXDHJS" }, "attempts": [], "status": "ERR", "last_attempt_at": 1763019227, "created_at": 1763019075, "next_attempt_at": 1763019226000 }, { "token": "wh_42b5ca938b35a948c70e7b178d160498", "type": "CARD_ADDED_SUCCESSFULLY", "data": { "id": null, "type": "gb_amex_card", "category": "card", "metadata": {}, "image": "", "webhook_url": "", "supporting_documentation": "", "next_action": "3d_verification", "full_name": { "first_name": "John", "middle_name": "Johnson", "last_name": "Doe" }, "account_name_inquiry": { "account_name_inquiry_result": "not_performed", "account_name_inquiry_details": { "last_name": null, "first_name": null, "middle_name": null } }, "name": "John Doe", "last4": "1111", "acs_check": "unchecked", "cvv_check": "unchecked", "bin_details": { "type": "DEBIT", "brand": "VISA", "level": "CLASSIC", "issuer": "CONOTOXIA SP. Z O.O", "country": "PL", "bin_number": "411111" }, "expiration_year": "30", "expiration_month": "12", "fingerprint_token": "ocfp_e599f990674473ce6283b245e9ad2467", "network_reference_id": 190960, "payment_account_reference": "V001Y3NV1Z3MFA32FNRW9IR3GQG27" }, "attempts": [], "status": "ERR", "last_attempt_at": 1763019454, "created_at": 1763019302, "next_attempt_at": 1763019454000 } ] } ```