This endpoint allows partners to consume notification events without exposing their endpoints to external access. This pattern provides a more granular control over the error handling and retries for a better management of failed notifications.
Notification events endpoint operates synchronously, meaning latency and performance impact especially for the high-volume or time-sensitive notifications, thus we strongly recommend using webhooks as it is less resource-intensive.
user.update
{"action":"verification","success":true,"timestamp":1671529439,"user_id":"1ed804ad-349c-61f8-a53d-826724196664"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
user.corporate-action
{"id":"1ed9020e-35f5-62ac-b802-369ecc33bc49","time":"2023-01-09T14:26:33+01:00","type":"dividend","ca_id":"1ed901d6-4c21-6676-86e7-e6645454d14d","fiat_id":1,"asset_id":397,"fiat_symbol":"EUR","asset_amount":"0.18876873","asset_symbol":"BAYN","user_id":"1ed7aabf-3bfb-6bb2-8821-8626d6ed9c94"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
user.non-user-initiated-tx
{"id":"1ed91009-a537-6fd0-a7bb-2eba2834ba6e","user_id":"1ed8b508-67a6-6722-99f3-f2ef672bfa54","asset_id":5,"asset_amount":"0.05465497","type":"staking_reward","direction":"incoming","created_at":"2023-01-10T16:05:29+00:00"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
user.non-user-initiated-tx-v2
{"id":"abcd1234-12ab-ab12-abcdef123456","user_id":"abcd1234-12ab-ab12-abcdef123456","asset_id":1,"fiat_id":1,"fiat_amount":"323000.78000000","asset_amount":"0.46987983466586","related_offer_id":"abcc89ac-1290-426f-8de0-4c7b40b91d3a","type":"giveaway","type_defined_for":"asset","direction":"incoming","created_at":"2024-01-09T13:08:00Z"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
account.send-money
{"id":"1ed80ed8-3393-64ca-ba25-46e31c542a97","trade_id":77356859,"reference":"bitpanda-63a294cf86761-transfer","timestamp":1671599311,"amount_sent":"5.00000000","fiat_symbol":"EUR","fiat_balance":"734651.06000000"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
account.send-money-success
{"id":"614c7a22-5abd-4511-aa99-5b3557e92e51","type":"withdrawal","reference":"bitpanda-62e9ba8a60608-transfer","timestamp": 1659484928,"fiat_amount":"31.00000000","fiat_symbol":"EUR"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
account.top-up
{"trade_id":1234567,"timestamp":1671580811,"fiat_symbol":"EUR","fiat_balance":"388256.25000000","amount_to_deposit":"611743"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
account.top-up-success
{"id":"1ed8065b-2a73-6b5e-b03f-2a65c999892d","type":"deposit","reference":"7945045137","timestamp":1671540979,"fiat_amount":"25.00000000","fiat_symbol":"EUR"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
user.savings-plan-notification
{"fiat_id": 1,"user_id":"1ed97e4a-912c-69be-9320-0aa759597920","asset_id": 1,"fiat_amount":"3124.00000000","savings_plan_id":"1ed97e71-c379-6648-b86a-ee5ee367ea13","savings_plan_day": 1,"savings_plan_status":"active","savings_plan_frequency":"weekly","external_transaction_id":"1ed97e89-682e-6cbc-8b84-f2ddd95107cf","savings_plan_created_at":"2023-01-19 10:50:38","savings_plan_next_recurrence":"2023-01-19 12:00:00","savings_plan_transaction_confirmation_deadline":"2023-01-19 11:00:00"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
user.savings-plan-trade-notification(failure)
{"user_id":"1ed97e4a-912c-69be-9320-0aa759597920","error_code":"403","error_message":"Saving plan transaction was not confirmed by 2023-01-19T11:00:00+00:00","savings_plan_id":"1ed97e71-c379-6648-b86a-ee5ee367ea13","external_transaction_id":"1ed97e89-682e-6cbc-8b84-f2ddd95107cf","savings_plan_transaction_status":"not_confirmed"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
user.savings-plan-trade-notification(success)
{"user_id":"1ed97d32-dcb7-6974-a846-c6a5060457b4","offer_id":"abadd2dc-cfd7-4411-b135-7cbcbb0823ae","trade_id":"6739ad92-bdb0-4948-b571-d27dda7fc6b5","savings_plan_id":"1ed97d7d-d845-6698-ab33-fe00d406bd61","external_transaction_id":"1ed97d86-d8df-6974-8601-f2ddd95107cf","savings_plan_transaction_status":"finished"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
user.crypto-transfer-notification
{"id": "4e465f96-6abf-4b91-9abb-f61b38eda58a", "fee": "0.0002000000000000", "address": "123456gPagfrEu2345Fmoqwe2weeei2ry1234567ABC", "user_id": "12345678-abcd-abcd-1234-123456789abc", "approved": true, "asset_id": 436, "credited": true, "currency": "EUR", "network_id": "12345678-1234-1234-1234-aaaabbbbcccc", "credited_at": null, "fiat_amount": "7.7000000000000000", "received_at": "2023-12-15T15:01:17.683653Z", "asset_amount": "0.1100000000000000", "asset_symbol": "SOL", "processed_at": null, "destination_tag": null, "asset_network_id": "1ede43b4-3348-6c84-a8d5-ad8ff12fd18a", "transaction_hash": "", "transaction_type": "withdrawal", "transaction_status": "finished", "tax_declaration_status": "undeclared"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
user.crypto-action
{"id":"00000000-abcd-1234-12ab-abcd4c841234","user_id":"abcd71c8-abcd-1234-12ab-abcd4c841234","type":"merger_crypto","credited_at":"2024-04-10T09:31:08Z","transactions":[{"id":"11111111-abcd-1234-12ab-abcd4c841234","asset_id":"aaaaaaaa-abcd-1234-12ab-abcd4c841234","asset_int":1,"fiat_id":"abcd71c8-abcd-1234-12ab-abcd4c841234","fiat_int":2,"asset_amount":"100.30","fiat_amount":"200.60","fee_amount":"0.5","type_defined_for":"asset","direction":"outgoing"},{"id":"22222222-abcd-1234-12ab-abcd4c841234","asset_id":"bbbbbbbb-abcd-1234-12ab-abcd4c841234","asset_int":2,"fiat_id":"abcd71c8-abcd-1234-12ab-abcd4c841234","fiat_int":2,"asset_amount":"100.30","fiat_amount":"200.60","fee_amount":"0.5","type_defined_for":"asset","direction":"incoming"}]}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
user.automated-order
{"user_id":"1ef2efc7-1d0c-658b-8bdb-7398fd6afe94","domain_slug":"b2b2c_qa","trade_id":"01ef5401-cf20-6165-b0cb-3e1e8185fb3c","asset_id":"a49406ee-ee33-11ec-aafe-062d595118ef","fiat_id":"ea96ccef-edee-11eb-9bf0-06502b1fe55d","asset_amount":"2.43667276","fiat_amount":"1","type":"buy","status":"finished","created_at":"2024-08-06T14:40:21.848515Z"}
For more details regarding the payload, please have a look at the request parameters for the corresponding webhook
Success Response
Error
Error
Maintenance or Service unavailable
{- "data": [
- {
- "id": "1ed83487-f684-62a2-a155-fe633f0db292",
- "type": "user.corporate-action",
- "payload": "{\"id\":\"1ed9020e-35f5-62ac-b802-369ecc33bc49\",\"time\":\"2023-01-09T14:26:33+01:00\",\"type\":\"dividend\",\"ca_id\":\"1ed901d6-4c21-6676-86e7-e6645454d14d\",\"fiat_id\":1,\"asset_id\":397,\"fiat_symbol\":\"EUR\",\"asset_amount\":\"0.18876873\",\"asset_symbol\":\"BAYN\",\"user_id\":\"1ed7aabf-3bfb-6bb2-8821-8626d6ed9c94\"}",
- "created_at": "2024-02-20T08:14:20+00:00"
}
], - "meta": {
- "size": 10
}, - "links": {
- "self": "/v1/events?size=10&type=user.update",
- "next": "/v1/events?size=10&after_id=018e18d0-bcc6-7ac7-a9bb-26d1b37dcc8f&type=user.update"
}
}