Get all notification subscriptions

curl --request GET \
  --url https://api.circle.com/v2/notifications/subscriptions \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
      "name": "Transactions Webhook",
      "endpoint": "https://example.org/handler/for/notifications",
      "enabled": true,
      "createDate": "2023-01-01T12:04:05Z",
      "updateDate": "2023-01-01T12:04:05Z",
      "notificationTypes": [
        "*"
      ],
      "restricted": false
    }
  ]
}

GET

notifications

subscriptions

Get all notification subscriptions

curl --request GET \
  --url https://api.circle.com/v2/notifications/subscriptions \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
      "name": "Transactions Webhook",
      "endpoint": "https://example.org/handler/for/notifications",
      "enabled": true,
      "createDate": "2023-01-01T12:04:05Z",
      "updateDate": "2023-01-01T12:04:05Z",
      "notificationTypes": [
        "*"
      ],
      "restricted": false
    }
  ]
}

Authorizations

Authorization

string

header

required

Circle's API Keys are formatted in the following structure "PREFIX:ID:SECRET". All three parts are requred to make a successful request.

Response

Successfully retrieved notification subscriptions.

data

Subscription · object[]

Show child attributes

data.id

string<uuid>

required

System-generated unique identifier of the resource.

Example:

"c4d1da72-111e-4d52-bdbf-2e74a2d803d5"

data.name

string

required

Name of the webhook notification subscription.

Example:

"Transactions Webhook"

data.endpoint

string

required

URL of the endpoint subscribing to notifications. Must be enabled to receive notifications.

Example:

"https://example.org/handler/for/notifications"

data.enabled

boolean

required

Whether the subscription is enabled. true indicates the subscription is enabled.

Example:

true

data.createDate

string<date-time>

required

Date and time the resource was created, in ISO-8601 UTC format.

Example:

"2023-01-01T12:04:05Z"

data.updateDate

string<date-time>

required

Date and time the resource was last updated, in ISO-8601 UTC format.

Example:

"2023-01-01T12:04:05Z"

data.notificationTypes

enum<string>[]

The notification types on which a notification will be sent.

Available options:

*,

transactions.*,

transactions.inbound,

transactions.outbound,

challenges.*,

challenges.accelerateTransaction,

challenges.cancelTransaction,

challenges.changePin,

challenges.contractExecution,

challenges.createTransaction,

challenges.createWallet,

challenges.initialize,

challenges.restorePin,

challenges.setPin,

challenges.setSecurityQuestions,

contracts.*,

contracts.eventLog,

modularWallet.*,

modularWallet.userOperation,

modularWallet.inboundTransfer,

modularWallet.outboundTransfer,

travelRule.*,

travelRule.statusUpdate,

travelRule.deny,

travelRule.approve,

rampSession.*,

rampSession.completed,

rampSession.depositReceived,

rampSession.expired,

rampSession.failed,

rampSession.kycApproved,

rampSession.kycRejected,

rampSession.kycSubmitted

Example:

["*"]

data.restricted

boolean

Whether the webhook is restricted to specific notification types. An unrestricted webhook will notify on all notification types. A restricted webhook will only notify on the notification types in the notificationTypes field.

Example:

false

Ping

Create a notification subscription

API Overview

Contracts

Get all notification subscriptions

Authorizations

Response