Manage Endpoint Subscriptions
Manage your Number/ Sender ID subscription status, all sender types are considered "endpoints".
Authorizations
Path parameters
workspaceIdstringRequired
endpointIdstringRequired
Responses
200
OK
application/json
Responseall of
404
Endpoint not found
application/json
get
GET /workspaces/{workspaceId}/endpoints/{endpointId}/subscriptions HTTP/1.1
Host:
Authorization: Bearer JWT
Accept: */*
{
"results": [
{
"name": "text",
"status": "active",
"price": {
"currencyCode": "EUR",
"amount": 1,
"exponent": 1
},
"subscription": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"correlationId": "123e4567-e89b-12d3-a456-426614174000",
"status": "active",
"subscribedAt": "2025-07-12T02:08:36.925Z",
"updatedAt": "2025-07-12T02:08:36.925Z",
"canceledAt": "2025-07-12T02:08:36.925Z",
"startAt": "2025-07-12T02:08:36.925Z",
"endAt": "2025-07-12T02:08:36.925Z"
}
}
]
}
Authorizations
Path parameters
workspaceIdstringRequired
endpointIdstringRequired
subscriptionNamestringRequired
Responses
200
OK
application/json
404
Not Found
application/json
get
GET /workspaces/{workspaceId}/endpoints/{endpointId}/subscriptions/{subscriptionName} HTTP/1.1
Host:
Authorization: Bearer JWT
Accept: */*
{
"name": "text",
"status": "active",
"price": {
"currencyCode": "EUR",
"amount": 1,
"exponent": 1
},
"subscription": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"correlationId": "123e4567-e89b-12d3-a456-426614174000",
"status": "active",
"subscribedAt": "2025-07-12T02:08:36.925Z",
"updatedAt": "2025-07-12T02:08:36.925Z",
"canceledAt": "2025-07-12T02:08:36.925Z",
"startAt": "2025-07-12T02:08:36.925Z",
"endAt": "2025-07-12T02:08:36.925Z"
}
}
Authorizations
Path parameters
workspaceIdstringRequired
endpointIdstringRequired
subscriptionNamestringRequired
Body
quantityinteger · min: 1Required
Responses
200
OK
application/json
404
Not Found
application/json
post
POST /workspaces/{workspaceId}/endpoints/{endpointId}/subscriptions/{subscriptionName}/activate HTTP/1.1
Host:
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 14
{
"quantity": 1
}
{
"name": "text",
"status": "active",
"price": {
"currencyCode": "EUR",
"amount": 1,
"exponent": 1
},
"subscription": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"correlationId": "123e4567-e89b-12d3-a456-426614174000",
"status": "active",
"subscribedAt": "2025-07-12T02:08:36.925Z",
"updatedAt": "2025-07-12T02:08:36.925Z",
"canceledAt": "2025-07-12T02:08:36.925Z",
"startAt": "2025-07-12T02:08:36.925Z",
"endAt": "2025-07-12T02:08:36.925Z"
}
}
Authorizations
Path parameters
workspaceIdstringRequired
endpointIdstringRequired
subscriptionNamestringRequired
Responses
200
OK
application/json
404
Not Found
application/json
post
POST /workspaces/{workspaceId}/endpoints/{endpointId}/subscriptions/{subscriptionName}/cancel HTTP/1.1
Host:
Authorization: Bearer JWT
Accept: */*
{
"name": "text",
"status": "active",
"price": {
"currencyCode": "EUR",
"amount": 1,
"exponent": 1
},
"subscription": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"correlationId": "123e4567-e89b-12d3-a456-426614174000",
"status": "active",
"subscribedAt": "2025-07-12T02:08:36.925Z",
"updatedAt": "2025-07-12T02:08:36.925Z",
"canceledAt": "2025-07-12T02:08:36.925Z",
"startAt": "2025-07-12T02:08:36.925Z",
"endAt": "2025-07-12T02:08:36.925Z"
}
}
Last updated
Was this helpful?