Manage Endpoint Subscriptions

Manage your Number/ Sender ID subscription status, all sender types are considered "endpoints".

List Workspace Endpoint Subscriptions

get
Authorizations
Path parameters
workspaceIdstringRequired
endpointIdstringRequired
Responses
200
OK
application/json
Responseall of
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"
      }
    }
  ]
}

Get Workspace Endpoint Subscription

get
Authorizations
Path parameters
workspaceIdstringRequired
endpointIdstringRequired
subscriptionNamestringRequired
Responses
200
OK
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"
  }
}

Activate Workspace Endpoint Subscription

post
Authorizations
Path parameters
workspaceIdstringRequired
endpointIdstringRequired
subscriptionNamestringRequired
Body
quantityinteger · min: 1Required
Responses
200
OK
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"
  }
}

Cancel Workspace Endpoint Subscription

post
Authorizations
Path parameters
workspaceIdstringRequired
endpointIdstringRequired
subscriptionNamestringRequired
Responses
200
OK
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?