API referenceGET

Preview pending keyword activation

Preview what upgrading the plan to cover every pending keyword would cost. Read-only: nothing is charged or activated.

GEThttps://ai.redreplier.com/ai-app/api/v1/keywords/activate-pending/preview

Preview what upgrading the plan to cover every pending keyword would cost. Read-only: nothing is charged or activated.

Bearer Token (RedReplier API token)

Parameters

This endpoint does not take path or query parameters.

Request body

This endpoint does not require a JSON body.

Response

Returns a keyword billing preview.

  • currentPlanName (string | null): Current plan name, or null when none is active.
  • currentMonthlyPrice (number): Current monthly price.
  • targetPlanName (string | null): Plan needed for the requested keyword count, or null when no change is needed.
  • targetMonthlyPrice (number): Monthly price after the change.
  • immediateCharge (number): Prorated immediate charge for the current billing period.
  • targetKeywords (number): Target active keyword count.
  • isUpgrade, isDowngrade, requiresImmediatePayment (boolean): Billing change flags.

Notes

Read-only. The API cannot upgrade the plan: make the change in the RedReplier app, then call Activate pending keywords or GET /websites to activate what now fits.

Errors

  • 400 Bad Request: Invalid input, URL, UUID, enum, query parameter, or body.
  • 401 Unauthorized: Missing or invalid Bearer token, or code: "token_issuer_lost_access" when the person who created the API key was deactivated or left the workspace.
  • 403 Forbidden: code: "subscription_required" when the workspace plan does not include API access, code: "workspace_access_denied" when X-Workspace-Id names a workspace this credential cannot reach, or code: "permission_denied" when your role in the workspace does not hold redreplier.write (Admin and Editor hold it).
  • 404 Not Found: The resource does not exist for the token account.
  • 429 Too Many Requests: Rate limit exceeded. Wait the seconds in Retry-After.
  • 500 Internal Server Error: Unexpected server error.
Example request (curl)
curl --request GET \
  --url https://ai.redreplier.com/ai-app/api/v1/keywords/activate-pending/preview \
  --header 'Authorization: Bearer redreplier_test_1234567890'
200
{
  "currentPlanName": "Starter",
  "currentMonthlyPrice": 49,
  "targetPlanName": "Growth",
  "targetMonthlyPrice": 99,
  "immediateCharge": 18.42,
  "targetKeywords": 25,
  "isUpgrade": true,
  "isDowngrade": false,
  "requiresImmediatePayment": true
}