Overview
Account administrators and agents sometimes need to quickly check which Kayako plan tier their instance is on, how many agent seats and collaborator licenses are included, and when the current subscription term expires. This information used to be visible on a dedicated Plan page in the admin interface, but that page has been discontinued and removed from the product. As a result, users may not know where to find these details today.
This information can still be retrieved directly, without needing to open a support request, by querying the instance's Plan API endpoint while logged in.
Solution or Explanation
Retrieving plan details via the API (self-service)
Any user who is logged in to a Kayako instance can retrieve the instance's current plan details by visiting the following URL in a browser while authenticated to that instance:
https://<instance_name>.kayako.com/api/v1/plan
Replace <instance_name> with the actual instance/domain name. The endpoint returns a JSON response describing the active subscription. The most commonly needed fields are:
| JSON field | Meaning |
|---|---|
data.name |
The subscribed plan tier (e.g., Growth, Enterprise), sometimes combined with the support level (Standard, Gold, Platinum) |
data.expiry_at |
The date/time (in UTC, ISO 8601 format) the current subscription term expires |
data.limits.agents |
The agent seat limit included in the plan |
data.limits.collaborators |
The collaborator license limit included in the plan |
data.limits.brands, data.limits.teams, etc. |
Additional plan limits (brands, teams, business hours, SLAs, channels, and so on) |
data.features |
An array of feature codes that are enabled for the subscribed plan/add-ons |
If only the expiry date is needed, the query can be narrowed with a field filter:
https://<instance_name>.kayako.com/api/v1/plan?fields=expiry_at
No admin console navigation is required — the endpoint can be accessed directly in a browser tab as long as the user is signed in to the instance.
Example
A typical response from the Plan API looks like this (values shown are illustrative only):
{ "status": 200, "data": { "name": "Growth", "expiry_at": "2029-02-03T00:00:00+00:00", "limits": { "agents": 10, "collaborators": 99, "brands": 99, "teams": 25 } } }
In this example, the plan is "Growth", the agent seat limit is 10, the collaborator limit is 99, and the current subscription term expires on February 3, 2029.
Verification
A successful check is confirmed when the /api/v1/plan endpoint returns an HTTP 200 status with a data object containing the plan name, expiry_at, and limits. If the endpoint returns an error or an empty response, the user may not be signed in to the instance, or the session may have expired — try logging in again and re-accessing the URL.
Additional Notes
- The dedicated Plan page under Admin > Account has been discontinued and removed from the Kayako interface. General account information is still available under the Home tab in the admin area, but seat, plan tier, and expiry details are best checked via the API method described above.
- This endpoint only reports the current entitlement values already applied to the instance. It does not allow changing the plan, seat count, or expiry date.
- To add agent seats, reach out to your renewals representative. To modify your subscription or reduce the number of seats in your contract, contact the Kayako sales team.
Go to Kayako Classic
Syed Haider
Comments