Subscription Management

The subscription management endpoints allow you to:

• See all available webhook subscriptions and related information

• See detailed information about your webhook subscriptions

• Renew your subscriptions

• Delete subscriptions

See the endpoints and their functions below:

Request type	Endpoint	Function
GET	/v2/subscriptions	See all your subscriptions, their status, creation, and expiration dates
GET	/v2/subscriptions/{subsription_id}	See the details of your active subscription
POST	/v2/subscriptions/{subscription_id}/renew	Renew your subscriptions for up to 1 year
DELETE	/v2/subscriptions/{subsription_id}	Delete your subscriptions

I want to see all my active subscriptions

Use the endpoint /v2/subscriptions to see all your available subscriptions, their statuses, creation and expiration dates:

1. Indicate if you want to see the details of active or expired subscriptions (expired = false OR expired = true) You will automatically see only active subscriptions if you omit the expired = true/false parameter.

2. Indicate which page number you would like to see. Each page contains approximately 1,000 subscriptions, so if you have more than 1,000 subscriptions, you may need to specify the page number.

3. Replace {API Key} with your API Key in the template below:

Request template

curl -X 'GET' \
  'https://api.coresignal.com/cdapi/v2/subscriptions?expired={false/true}&page={integer}' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}'

1. Send the request.

2. Refer to the Body for information about your subscription status:

[
  {
    "id": "c8e295c0-2f85-473d-8bef-350526e6b30a",
    "status": "active",
    "created_at": "2024-09-18",
    "expiring_at": "2024-12-18"
  },
  {
    "id": "a85b2528-6190-4c91-8489-364b27ccbf81",
    "status": "active",
    "created_at": "2024-09-18",
    "expiring_at": "2024-12-18"
  }
]

Data field	Description	Data type
id	Subscription identification key. Subscription ID is displayed in the response body after submitting a webhook subscription	String
status	Subscription status (active or expired)	String
created_at	Subscription start date in YYYY-MM-DD format	String (date)
expiring_at	Subscription expiry date in YYYY-MM-DD format	String (date)

---

I want to see the details of my subscription

Use the endpoint /v2/subscriptions/{subscription_id} to see the details of your expired or active subscriptions:

1. Provide your {subscription_id}*. 📌*Subscription ID is displayed in the response body after successfully submitting a webhook subscription.

2. Replace {API Key} with your API Key in the template below:

Request template

curl -X 'GET' \
  'https://api.coresignal.com/cdapi/v2/subscriptions/{subscription_id}' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}'

1. Send the request.

2. You will see the following information in the Response body:

{
  "id": "c8e295c0-2f85-473d-8bef-350526e6b30a",
  "status": "active",
  "created_at": "2024-09-18",
  "expiring_at": "2024-12-18",
  "entity": "member_changes",
  "es_dsl_query": null, 
  "filters": null,
  "last_webhook_sent": "2024-09-30"
}

Data field	Description	Data type
id	Subscription identification key.	String
status	Subscription status (active or expired)	String
created_at	Subscription start date in YYYY-MM-DD format	String (date)
expiring_at	Subscription expiry date in YYYY-MM-DD format	String (date)
entity	Subscription entity	String
es_dsl_query	Elasticsearch DSL query used to subscribe to changes in a list of profiles	Object
filters	Search filters used to subscribe to changes in a list of profiles	Object
last_webhook_sent	Time of the last message sent to your webhook URL in YYYY-MM-DD format	String (date)

I want to renew my subscription

Use the endpoint /v2/subscriptions/{subscription_id}/renew to renew your subscriptions. A webhook subscription is valid for 91 days from the date it is created. To maintain uninterrupted webhook delivery beyond this window, subscriptions must be renewed before they expire.

Renewals can be scheduled in advance, allowing coverage for up to approximately one year from the initial subscription start date.

A subscription can be renewed for up to 1 year. If subscription renewal exceeds this period, the request will be cancelled.

1. Provide your subscription_ID.

2. Replace {API Key} with your API Key.

Request template

curl -X 'POST' \
  'https://api.coresignal.com/cdapi/v2/subscriptions/{subscription_id}/renew' \
  -H 'accept: application/json' \
  -H 'apikey: {API Key}'

1. Send the request.

2. You will see the following information in the Response body:

Response

{
    "id": "4e11dcae-9bfb-4edb-b4f6-a0991b20fb50",
    "status": "active",
    "created_at": "2025-04-24T12:00:00.000000",
    "expiring_at": "2025-10-24T12:00:00.000000",
}

Data field	Description	Data type
id	Subscription identification key.	String
status	Subscription status (active or expired)	String
created_at	Subscription start date	String (date)
expiring_at	Subscription expiry date	String (date)

I want to delete my subscription

Use the endpoint DELETE /v2/subscriptions/{subscription_id} to make your subscriptions inactive.

Use your subscription ID as input to request updates to employee profiles or experience changes. Refer to the template below:

Template

curl -X 'DELETE' \
  'https://api.coresignal.com/cdapi/v2/subscriptions/{subscription_id}' \
  -H 'accept: */*' \
  -H 'apikey: {API Key}'