Deskhero Developer Hub
Back to deskhero.com
Plans

Get limits

Returns the plans the workspace can choose between with the limits of each, together with the workspace's current usage per limit and its trial state.

GET /api/{tenant:minlength(2)}/v{version:apiVersion}/plans/get_limits
Authorisation
Minimum role: ADMIN

Request arguments

Name Type Source
Request body example
No input arguments

Response

Status
200 (OK)
Type
DTO_plan_limits
Wrapper
DTO_response_wrap
Other statuses
400 (BadRequest), 403 (Forbidden)
Response body example
DTO_plan_limits
NameTypeReadOnlyDescription
current_planENUM tenant_planCurrent plan
is_trialBooleanIs trial
trial_end_dateDateTime (nullable)Trial end date
expired_trialBooleanExpired trial
capped_amountDTO_capped_amountCapped amount
plansDTO_plan_limit[]Plans
usageDTO_plan_limitUsage
DTO_capped_amount
NameTypeReadOnlyDescription
is_shopify_paymentBooleanReadOnlyIs shopify payment
current_user_countInt32ReadOnlyCurrent user count
current_invite_countInt32ReadOnlyCurrent invite count
require_increaseBooleanReadOnlyRequire increase
minimum_required_capDoubleReadOnlyMinimum required cap
current_capDoubleReadOnlyCurrent cap
DTO_plan_limit
NameTypeReadOnlyDescription
planENUM tenant_planPlan
price_usdDoublePrice usd
price_usd_minimumDoublePrice usd minimum
ticketsInt32Tickets
ai_suggested_answersBooleanAi suggested answers
mailboxesInt32Mailboxes
kbsInt32Kbs
web_scraped_pagesInt32Web scraped pages
integration_shopify_customer_cardBooleanIntegration shopify customer card
integration_shopify_product_syncInt32Was a bool hardcoded true, which hid a limit that is actually enforced (PlanSpecs.MaxNumShopifyProductsSync, PlanUsageEntity.SHOPIFY_PRODUCTS_SYNC). The public pricing page has always advertised it as a per-plan number, so this now carries the number.
automation_rulesInt32Automation rules
formsInt32Forms
multilingual_conversationsBooleanMultilingual conversations
ai_training_dataBooleanAi training data
sso_google_microsoftBooleanSso google microsoft
api_accessBooleanApi access
listsInt32Lists
list_entriesInt32List entries
fieldsInt32Fields
groupsInt32Groups
sla_policiesBooleanThe only feature flag here backed by real data (PlanSpec.EnableSla, per-tenant override on PlanSpecDeviation.EnableSla, plus the global TempEnableSla kill switch). Everything below is hardcoded true - included on every plan - and exists so the in-app plan table lists the same features as the public pricing page.
statisticsBooleanStatistics
email_attachment_readingBooleanEmail attachment reading
ai_chat_botBooleanAi chat bot
public_faqBooleanPublic faq
auto_replies_from_faqBooleanAuto replies from faq
insightsBooleanInsights
chat_bot_sessionsInt32NOT ENFORCED. The public pricing page advertises 500/2000/5000 sessions per month, but nothing in the backend counts or caps them - there is no PlanSpecs column and no PlanUsageEntity. Surfaced here so the in-app plan table can state the same thing the customer was sold; move it to real plan data if the limit is ever implemented, and populate DTO_plan_limits.usage for it at the same time.
notifications_and_mentionsBooleanNotifications and mentions
ticket_forwardingBooleanTicket forwarding
agents_includedInt32Agents included
free_trial_daysInt32Free trial days
ENUM tenant_plan
ValueNameDescription
0UNKNOWNUNKNOWN
1FREEFREE
2SMALLSMALL
3MEDIUMMEDIUM
4LARGELARGE

Generated Aug 4, 2026 18:37