comecerodocs

Get subscription history

GET
/subscriptions/{subscription_id}/history

Returns the change log of a subscription: who changed what and when. Core keeps the last 100 entries. Secret and trusted tokens may call it; a limited token may not (403).

Authorization

headerAuthorizationBearer <token>

A secret, trusted or limited token. See Authentication.

Path Parameters

subscription_id*string

The subscription id.

Query Parameters

formatted?boolean

When true, the object also has a formatted child with amounts and dates as display text in the shopper's language and currency (for example $19.99 or November 7, 2026). The default is false. See Localized formatting.

Defaultfalse

Response Body

The subscription history.

application/json
  1. response

The change log of a subscription: cancellations, scheduled changes, payments for changes, extensions and so on. Core keeps the last 100 entries.

object*"subscription_history"

The object type. Always subscription_history.

Value in"subscription_history"
subscription_id*|

The subscription id. null when nothing has been logged yet.

test*boolean

true for a test subscription.

entries*array<>

The log entries, oldest first.

Example Request
curl -X GET 'https://api.comecero.com/api/v1/subscriptions/string/history'
Example Response
{  "object": "subscription_history",  "subscription_id": "0093799318129SuLByRPW8",  "test": true,  "entries": [    {      "date_created": "2026-11-02T15:21:31Z",      "initiated_by": "Administrator",      "description": "The current billing period has been extended by 7 days"    },    {      "date_created": "2026-11-05T09:12:44Z",      "initiated_by": "customer",      "description": "The subscription has been scheduled to be cancelled at the end of the current billing period"    }  ]}