curl --request GET \
--url https://hpay-api.host-sl.com/api/v1/webhooks/subscriptions \
--header 'api-key: YOUR_API_KEY' \
--header 'secret-key: YOUR_SECRET_KEY'
from hostpay import HostPay
client = HostPay(api_key="YOUR_API_KEY", secret_key="YOUR_SECRET_KEY")
for sub in client.webhooks.subscriptions.list():
print(sub["id"], sub["target_url"], sub["active"])
import { HostPay } from "@hostpay/sdk";
const client = new HostPay({ apiKey: "YOUR_API_KEY", secretKey: "YOUR_SECRET_KEY" });
const subs = await client.webhooks.subscriptions.list();
subs.forEach((s) => console.log(s.id, s.target_url, s.active));
[
{
"id": "7c1d2e3f-...",
"application_id": "2e35e07e-...",
"target_url": "https://example.com/webhooks/hostpay",
"events": ["deposit.completed", "payout.failed"],
"active": true,
"ip_allowlist": null,
"payload_version": "2025-01",
"secret_preview": "...k3Qz",
"created_at": "2026-07-04T10:30:00Z",
"updated_at": "2026-07-04T10:30:00Z"
}
]
Webhook Subscriptions
List Subscriptions
List all webhook subscriptions for your application.
GET
/
api
/
v1
/
webhooks
/
subscriptions
curl --request GET \
--url https://hpay-api.host-sl.com/api/v1/webhooks/subscriptions \
--header 'api-key: YOUR_API_KEY' \
--header 'secret-key: YOUR_SECRET_KEY'
from hostpay import HostPay
client = HostPay(api_key="YOUR_API_KEY", secret_key="YOUR_SECRET_KEY")
for sub in client.webhooks.subscriptions.list():
print(sub["id"], sub["target_url"], sub["active"])
import { HostPay } from "@hostpay/sdk";
const client = new HostPay({ apiKey: "YOUR_API_KEY", secretKey: "YOUR_SECRET_KEY" });
const subs = await client.webhooks.subscriptions.list();
subs.forEach((s) => console.log(s.id, s.target_url, s.active));
[
{
"id": "7c1d2e3f-...",
"application_id": "2e35e07e-...",
"target_url": "https://example.com/webhooks/hostpay",
"events": ["deposit.completed", "payout.failed"],
"active": true,
"ip_allowlist": null,
"payload_version": "2025-01",
"secret_preview": "...k3Qz",
"created_at": "2026-07-04T10:30:00Z",
"updated_at": "2026-07-04T10:30:00Z"
}
]
Returns every subscription on your application. Signing secrets are never included — only a
secret_preview for identification.
Response
string
The subscription ID.
string
The HTTPS endpoint deliveries are sent to.
string[]
The event types this subscription receives (see Webhook events).
boolean
Whether deliveries are currently enabled.
string[] | null
Optional source-IP allowlist enforced on delivery.
string
The payload schema version (e.g.
2025-01).string
The last few characters of the signing secret, for identification only.
string
ISO 8601 creation timestamp.
[
{
"id": "7c1d2e3f-...",
"application_id": "2e35e07e-...",
"target_url": "https://example.com/webhooks/hostpay",
"events": ["deposit.completed", "payout.failed"],
"active": true,
"ip_allowlist": null,
"payload_version": "2025-01",
"secret_preview": "...k3Qz",
"created_at": "2026-07-04T10:30:00Z",
"updated_at": "2026-07-04T10:30:00Z"
}
]
curl --request GET \
--url https://hpay-api.host-sl.com/api/v1/webhooks/subscriptions \
--header 'api-key: YOUR_API_KEY' \
--header 'secret-key: YOUR_SECRET_KEY'
from hostpay import HostPay
client = HostPay(api_key="YOUR_API_KEY", secret_key="YOUR_SECRET_KEY")
for sub in client.webhooks.subscriptions.list():
print(sub["id"], sub["target_url"], sub["active"])
import { HostPay } from "@hostpay/sdk";
const client = new HostPay({ apiKey: "YOUR_API_KEY", secretKey: "YOUR_SECRET_KEY" });
const subs = await client.webhooks.subscriptions.list();
subs.forEach((s) => console.log(s.id, s.target_url, s.active));