Get current plan details

Retrieve details about your current pricing plan

GET/api/v2/billing/plan

Authorization

AuthorizationBearer token (Anlyon API key) · headerrequired

Workspace API key sent as Authorization: Bearer <key>.

better-auth.session_tokenAPI key · cookierequired

Browser session used by dashboard-only operations.

Header parameters

X-Request-Idstring

Optional caller correlation ID. Unsafe or oversized values are replaced.

max length 128

Responses

200

Provider-safe plan, limits, pricing, and subscription state returned.

successbooleanrequired

Allowed:true

dataobjectrequired

Show properties

accessBillingAccess

How this workspace is served right now. Server-controlled and shared by enforcement, the console, and public pricing.

Show properties

modestringrequired

Allowed:early_betastandard

betaAllowancesApplybooleanrequired

paidPlansAvailablebooleanrequired

Whether a paid plan can be bought right now. Purchase endpoints return PAID_PLANS_UNAVAILABLE when false., example: false

betaAllowancesEndAtstring<date-time> | nullrequired

Only set once normal pricing is open, and only while this workspace still has beta allowances. The end date is fixed once set.

usageResetsAtstring<date-time>required

The next UTC month boundary, when monthly allowances reset.

overageBillingbooleanrequired

Early Beta Access never bills overage.

Allowed:false

automaticChargesbooleanrequired

Nothing is charged or upgraded automatically.

Allowed:false

betaAllowancesBetaAllowances

The Early Beta Access allowances, derived from the limits the API enforces. Null means the dimension has no fixed cap.

Show properties

actionExecutionsPerMonthinteger | nullrequired

durableMessagesPerMonthinteger | nullrequired

actionDefinitionsinteger | stringrequired

Show properties

One of:

integer

integer

string

string

seatsIncludingPendingInvitationsinteger | stringrequired

Show properties

One of:

integer

integer

string

string

environmentsinteger | stringrequired

Total environments a workspace may hold, of any kind.

Show properties

One of:

integer

integer

string

string

combinedStorageBytesinteger | nullrequired

Capacity in bytes. Does not reset monthly., example: 1073741824

memoryStorageMbinteger | stringrequired

Counted within combined storage.

Show properties

One of:

integer

integer

string

string

storedMemoriesinteger | stringrequired

Show properties

One of:

integer

integer

string

string

egressBytesPerMonthinteger | nullrequired

traceRetentionDaysintegerrequired

memoryProcessingAllowanceCentsintegerrequired

Internal monthly processing allowance in cents. Not a token price., example: 25

planstringrequired

Allowed:freepaygoenterpriseproductiongrowth

pendingPlanstring | null

Requested period-end target. Resource creation is restricted to this plan while the change is pending., example: free

limitsBillingPlanLimitsrequired

Show properties

maxSeatsQuotaLimit

Show properties

One of:

integer

integer

string

string

maxActionsQuotaLimit

Show properties

One of:

integer

integer

string

string

maxEnvironmentsQuotaLimit

Show properties

One of:

integer

integer

string

string

traceRetentionDaysinteger

traceArchivalboolean

usagePolicyBillingUsagePolicies

Show properties

actionInvokesBillingUsagePolicy

Show properties

One of:

object

kindstringrequired

Allowed:hard-cap

capUnitsintegerrequired

min 0

object

kindstringrequired

Allowed:included-then-overage

includedUnitsintegerrequired

min 0

overageCentsPerUnitnumberrequired

min 0

object

kindstringrequired

Allowed:unlimited

messagesBillingUsagePolicy

storageBillingUsagePolicy

bandwidthBillingUsagePolicy

maxMessagesPerDayQuotaLimitrequired

Show properties

One of:

integer

integer

string

string

maxMonthlyMessagesQuotaLimitrequired

Show properties

One of:

integer

integer

string

string

maxMonthlyBandwidthintegerrequired

Bytes.

min 0

maxRetriesintegerrequired

min 0

maxMessageSizeintegerrequired

Bytes.

min 0

maxHttpTimeoutintegerrequired

Milliseconds.

min 0

rateLimitobjectrequired

Show properties

requestsPerMinuteQuotaLimitrequired

Show properties

One of:

integer

integer

string

string

requestsPerHourQuotaLimitrequired

Show properties

One of:

integer

integer

string

string

maxBatchSizeintegerrequired

min 1

maxConcurrentDeliveriesQuotaLimitrequired

Show properties

One of:

integer

integer

string

string

maxActiveSchedulesQuotaLimitrequired

Show properties

One of:

integer

integer

string

string

maxActiveWorkflowsQuotaLimitrequired

Show properties

One of:

integer

integer

string

string

maxActiveUrlGroupsQuotaLimitrequired

Show properties

One of:

integer

integer

string

string

analyticsRetentionDaysQuotaLimitrequired

Show properties

One of:

integer

integer

string

string

logRetentionDaysQuotaLimitrequired

Show properties

One of:

integer

integer

string

string

maxMonthlyAssistantReviewsobject

Anlyon Vigil (Beta) reviews per UTC month. A hard cap; at the cap approvals are reviewed without a suggestion.

Show properties

object

maxDailyAssistantAutoApprovalsobject

Approvals Anlyon Vigil may make per UTC day. A hard cap; at the cap requests go to a person.

Show properties

object

maxApprovalPoliciesPerEnvironmentobject

Approval policies one environment may hold.

Show properties

object

maxMonthlyConditionDraftsinteger

Plain-English policy condition drafts per workspace per UTC month. Complimentary during the beta.

min 0

featuresBillingPublicFeaturesrequired

Show properties

protectedProductionboolean

controlledPromotionboolean

customHeadersbooleanrequired

urlGroupsbooleanrequired

schedulesbooleanrequired

webhooksbooleanrequired

workflowsbooleanrequired

memorybooleanrequired

eventsbooleanrequired

filesbooleanrequired

semanticCachebooleanrequired

sessionsbooleanrequired

actionsbooleanrequired

approvalsbooleanrequired

budgetsbooleanrequired

analyticsbooleanrequired

prioritySupportbooleanrequired

slabooleanrequired

dedicatedSupportbooleanrequired

pricingBillingRawPricingrequired

Machine-readable pricing values in cents unless the field says otherwise.

Show properties

monthlyFeenumberrequired

min 0

perMessageCostnumberrequired

min 0

includedMessagesintegerrequired

min 0

bandwidthOverageCostnumberrequired

min 0

perMemoryOperationCostnumberrequired

min 0

perEmbeddingTokenCostnumberrequired

min 0

perLlmTokenCostnumberrequired

min 0

perRerankOpCostnumberrequired

min 0

perMemoryStorageMbCostnumberrequired

min 0

perEventPublishCostnumberrequired

min 0

perFileStorageMbCostnumberrequired

min 0

perCacheLookupCostnumberrequired

min 0

perActionInvokeCostnumberrequired

min 0

featuresBillingPublicFeaturesrequired

Show properties

protectedProductionboolean

controlledPromotionboolean

customHeadersbooleanrequired

urlGroupsbooleanrequired

schedulesbooleanrequired

webhooksbooleanrequired

workflowsbooleanrequired

memorybooleanrequired

eventsbooleanrequired

filesbooleanrequired

semanticCachebooleanrequired

sessionsbooleanrequired

actionsbooleanrequired

approvalsbooleanrequired

budgetsbooleanrequired

analyticsbooleanrequired

prioritySupportbooleanrequired

slabooleanrequired

dedicatedSupportbooleanrequired

pricingBillingDisplayPricingrequired

Show properties

monthlyFeenumberrequired

Major currency units.

min 0

perMessageCostnumberrequired

Cents per message, retained for backward compatibility.

min 0

includedMessagesintegerrequired

min 0

bandwidthOverageCostnumberrequired

Major currency units per GB.

min 0

includedBandwidthstringrequired

Human-readable byte count., example: 50 GB

subscriptionBillingSubscriptionSummaryrequired

Provider-safe subscription state; Stripe identifiers are never returned.

Show properties

statusstring | nullrequired

isCustomerConfiguredbooleanrequired

hasSubscriptionbooleanrequired

trialEndsAtstring<date-time> | nullrequired

401

Unauthorized - Invalid or missing API key

successbooleanrequired

requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired

Show properties

codestring

messagestring

detailsobject

403

Authenticated credential lacks the required scope or workspace access.

successbooleanrequired

requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired

Show properties

codestring

messagestring

detailsobject

404

Not Found - Resource does not exist

successbooleanrequired

requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired

Show properties

codestring

messagestring

detailsobject

429

Too Many Requests - Rate limit exceeded

successbooleanrequired

requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired

Show properties

codestring

messagestring

detailsobject

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (Anlyon API key)Remember on this deviceInclude my values in samples

Parameters

X-Request-IdheaderOptional caller correlation ID. Unsafe or oversized values are replaced.

Request

curl -X GET 'https://api.anlyon.com/api/v2/billing/plan' \
  -H 'Authorization: Bearer YOUR_TOKEN'

const response = await fetch("https://api.anlyon.com/api/v2/billing/plan", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.anlyon.com/api/v2/billing/plan",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "success": true,
  "data": {
    "access": {
      "mode": "early_beta",
      "betaAllowancesApply": true,
      "paidPlansAvailable": true,
      "betaAllowancesEndAt": "2019-08-24T14:15:22Z",
      "usageResetsAt": "2019-08-24T14:15:22Z",
      "overageBilling": false,
      "automaticCharges": false
    },
    "betaAllowances": {
      "actionExecutionsPerMonth": 10000,
      "durableMessagesPerMonth": 25000,
      "actionDefinitions": 10,
      "seatsIncludingPendingInvitations": 3,
      "environments": 3,
      "combinedStorageBytes": 0,
      "memoryStorageMb": 50,
      "storedMemories": 2000,
      "egressBytesPerMonth": 53687091200,
      "traceRetentionDays": 14,
      "memoryProcessingAllowanceCents": 0
    },
    "plan": "production",
    "pendingPlan": "string",
    "limits": {
      "maxSeats": 0,
      "maxActions": 0,
      "maxEnvironments": 0,
      "traceRetentionDays": 0,
      "traceArchival": true,
      "usagePolicy": {
        "actionInvokes": {
          "kind": "hard-cap",
          "capUnits": 0
        },
        "messages": {
          "kind": "hard-cap",
          "capUnits": 0
        },
        "storage": {
          "kind": "hard-cap",
          "capUnits": 0
        },
        "bandwidth": {
          "kind": "hard-cap",
          "capUnits": 0
        }
      },
      "maxMessagesPerDay": 0,
      "maxMonthlyMessages": 0,
      "maxMonthlyBandwidth": 0,
      "maxRetries": 0,
      "maxMessageSize": 0,
      "maxHttpTimeout": 0,
      "rateLimit": {
        "requestsPerMinute": 0,
        "requestsPerHour": 0
      },
      "maxBatchSize": 1,
      "maxConcurrentDeliveries": 0,
      "maxActiveSchedules": 0,
      "maxActiveWorkflows": 0,
      "maxActiveUrlGroups": 0,
      "analyticsRetentionDays": 0,
      "logRetentionDays": 0,
      "maxMonthlyAssistantReviews": 0,
      "maxDailyAssistantAutoApprovals": 0,
      "maxApprovalPoliciesPerEnvironment": 0,
      "maxMonthlyConditionDrafts": 0,
      "features": {
        "protectedProduction": true,
        "controlledPromotion": true,
        "customHeaders": true,
        "urlGroups": true,
        "schedules": true,
        "webhooks": true,
        "workflows": true,
        "memory": true,
        "events": true,
        "files": true,
        "semanticCache": true,
        "sessions": true,
        "actions": true,
        "approvals": true,
        "budgets": true,
        "analytics": true,
        "prioritySupport": true,
        "sla": true,
        "dedicatedSupport": true
      },
      "pricing": {
        "monthlyFee": 0,
        "perMessageCost": 0,
        "includedMessages": 0,
        "bandwidthOverageCost": 0,
        "perMemoryOperationCost": 0,
        "perEmbeddingTokenCost": 0,
        "perLlmTokenCost": 0,
        "perRerankOpCost": 0,
        "perMemoryStorageMbCost": 0,
        "perEventPublishCost": 0,
        "perFileStorageMbCost": 0,
        "perCacheLookupCost": 0,
        "perActionInvokeCost": 0
      }
    },
    "features": {
      "protectedProduction": true,
      "controlledPromotion": true,
      "customHeaders": true,
      "urlGroups": true,
      "schedules": true,
      "webhooks": true,
      "workflows": true,
      "memory": true,
      "events": true,
      "files": true,
      "semanticCache": true,
      "sessions": true,
      "actions": true,
      "approvals": true,
      "budgets": true,
      "analytics": true,
      "prioritySupport": true,
      "sla": true,
      "dedicatedSupport": true
    },
    "pricing": {
      "monthlyFee": 0,
      "perMessageCost": 0,
      "includedMessages": 0,
      "bandwidthOverageCost": 0,
      "includedBandwidth": "string"
    },
    "subscription": {
      "status": "string",
      "isCustomerConfigured": true,
      "hasSubscription": true,
      "trialEndsAt": "2019-08-24T14:15:22Z"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_ERROR",
    "message": "Invalid or missing API key"
  }
}

{
  "success": false,
  "requestId": "req_0123456789abcdef0123456789abcdef",
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request data",
    "details": {}
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found"
  }
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Please try again later."
  }
}