List all notification events per partner

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.

Payload examples for available types:

  • 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

SecuritybearerAuth
Request
query Parameters
type
string

Event type.

Enum: "user.corporate-action" "user.non-user-initiated-tx" "user.non-user-initiated-tx-v2" "user.update" "user.savings-plan-notification" "user.savings-plan-trade-notification" "user.crypto-transfer-notification" "account.send-money" "account.send-money-success" "account.top-up" "account.top-up-success" "user.crypto-action"
Example: type=user.corporate-action
size
integer

Number of events to be displayed per page. Maximum value is 50.

Example: size=20
after_id
string <uuid>

A cursor for use in pagination. after_id is an Event ID that defines your place in the list.

Example: after_id=1ed804ad-41e9-6fc2-bf32-1e7e399643fb
Responses
200

Success Response

401

Error

422

Error

503

Maintenance or Service unavailable

get/v1/events
Request samples
Response samples
application/json
{
  • "data": [
    ],
  • "meta": {
    },
  • "links": {
    }
}