Skip to content

Keep the current paid plan and undo a cancellation scheduled for the end of the billing cycle.

POST
/account/subscription/resume
curl --request POST \
--url https://api.pingram.io/account/subscription/resume \
--header 'Authorization: Bearer <token>'

Authorizations

Responses

200

Successful response

Media typeapplication/json

GET /account response: public plan fields for the authenticated account.

object
accountId
required
string
accountType
required
string
Allowed values: free paid
creator
string
name
string
messagesCap
required
number
costCap
required
number
smsCap
number
callCap
number
billingVersion

When omitted, defaults to LATEST_BILLING_VERSION.

number
Allowed values: 1 3
anniversaryDate
required

ISO date (YYYY-MM-DD) when the billing cycle resets.

string
createdAt
required
string
updatedAt
required
string
status
string
Allowed values: verified unverified blocked
subscriptionStatus
string
nullable
Allowed values: active canceled past_due paused
pendingDowngradeEffectiveDate
string
pendingDowngradeCostCap
number
pendingDowngradeAccountType
string
Allowed values: free
autoUpgrade

When true, paid accounts move up one budget tier at 90% of the monthly budget.

boolean
billingAlerts

Email alerts for monthly usage. New accounts start enabled for the creator at 80% and 100%.

object
enabled
required

When false, saved addresses and thresholds are kept but no email is sent.

boolean
emails
required

Addresses that receive threshold emails. At most three.

Array<string>
thresholds
required

Percents to email, from 5 to 100 in steps of 5. At most two. At least one is required while enabled.

Array<number>
Example
{
"accountType": "free",
"billingVersion": 1,
"status": "verified",
"subscriptionStatus": "active",
"pendingDowngradeAccountType": "free"
}

400

Bad Request - validation errors, invalid input

Media typeapplication/json

Standard error response for API errors.

object
trackingId
required

Unique tracking ID for the request.

string
error
required

Structured error details for API error responses.

object
code
required

Machine-readable error code.

string
message
required

Human-readable error message.

string
fix

Actionable hint for fixing the error.

string
Examplegenerated
{
"trackingId": "example",
"error": {
"code": "example",
"message": "example",
"fix": "example"
}
}

401

Unauthorized

402

Payment Required - usage limits exceeded

Media typeapplication/json

Standard error response for API errors.

object
trackingId
required

Unique tracking ID for the request.

string
error
required

Structured error details for API error responses.

object
code
required

Machine-readable error code.

string
message
required

Human-readable error message.

string
fix

Actionable hint for fixing the error.

string
Examplegenerated
{
"trackingId": "example",
"error": {
"code": "example",
"message": "example",
"fix": "example"
}
}

500

Internal Server Error

502

Bad Gateway - provider error

Media typeapplication/json

Standard error response for API errors.

object
trackingId
required

Unique tracking ID for the request.

string
error
required

Structured error details for API error responses.

object
code
required

Machine-readable error code.

string
message
required

Human-readable error message.

string
fix

Actionable hint for fixing the error.

string
Examplegenerated
{
"trackingId": "example",
"error": {
"code": "example",
"message": "example",
"fix": "example"
}
}