Chronary Plans API
The Plans API from Chronary — 1 operation(s) for plans.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/chronary-ai:chronary-ai-plans-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Chronary Plans API
version: 1.0.0
description: 'Calendar-as-a-service API for AI agents.
Manage calendars, events, and availability for AI and human agents.
All endpoints require an API key passed as a Bearer token.
**Authentication:** `Authorization: Bearer chr_sk_...` or `Authorization: Bearer chr_ak_...`
**Rate limit:** 10 requests/second per API key. Exceeds return HTTP 429.
**Quotas:** Monthly operation limits by plan — see Billing & plans and Rate limits.
**Agent bootstrap:** Custom extensions prefixed `x-agent-*` describe the self-signup flow for AI agents. These are not part of any registered OpenAPI extension — they are a Chronary convention.'
contact:
name: Chronary Support
email: support@chronary.ai
url: https://docs.chronary.ai
servers:
- url: https://api.chronary.ai
description: Production
security:
- BearerAuth: []
tags:
- name: Plans
paths:
/v1/plans:
get:
operationId: listPlans
summary: List plans
description: 'Returns the catalog of publicly-available plans with pricing, limits, and display metadata. No authentication required; IP-rate-limited. Responses are cacheable (`Cache-Control: public, max-age=300, s-maxage=3600, stale-while-revalidate=86400`) with an `ETag` for 304 conditional requests.'
tags:
- Plans
security: []
responses:
'200':
description: Plan catalog
content:
application/json:
schema:
type: object
properties:
plans:
type: array
items:
$ref: '#/components/schemas/Plan'
required:
- plans
'304':
description: ETag matched — no body
components:
schemas:
PlanLimits:
type:
- object
- 'null'
properties:
agents:
type:
- integer
- 'null'
calendars:
type:
- integer
- 'null'
events:
type:
- integer
- 'null'
api_calls:
type:
- integer
- 'null'
webhook_deliveries:
type:
- integer
- 'null'
availability_queries:
type:
- integer
- 'null'
ical_subscriptions:
type:
- integer
- 'null'
proposals:
type:
- integer
- 'null'
webhook_endpoints:
type:
- integer
- 'null'
description: Max active webhook subscription endpoints per org.
scoped_keys:
type:
- integer
- 'null'
description: Max live agent-scoped API keys (`chr_ak_*`) per org.
recurring_events:
type:
- integer
- 'null'
description: Max active recurring event series per org. Free-plan series must also be bounded (COUNT or UNTIL) and end within 90 days of the series start.
booking_pages:
type:
- integer
- 'null'
description: Max active public booking pages per org.
required:
- agents
- calendars
- events
- api_calls
- webhook_deliveries
- availability_queries
- ical_subscriptions
- proposals
- webhook_endpoints
- scoped_keys
- recurring_events
- booking_pages
description: Enforced caps. `null` for the custom-priced tier (negotiated separately).
Plan:
type: object
properties:
id:
type: string
enum:
- free
- pro
- custom
name:
type: string
example: Pro
tagline:
type: string
example: For production agent workflows
price:
type:
- integer
- 'null'
description: Recurring monthly amount in the smallest currency unit (e.g. USD cents). `null` for the custom-priced tier.
example: 2900
currency:
type:
- string
- 'null'
description: Lowercase ISO-4217 code. `null` for the custom-priced tier.
example: usd
limits:
$ref: '#/components/schemas/PlanLimits'
display_features:
type: array
items:
type: string
description: Marketing copy for UI rendering. Not machine-readable — use `limits` for capability checks.
recommended:
type: boolean
description: Hint for UIs to highlight one tier (currently `pro`).
custom_pricing:
type: boolean
description: Present and `true` for the custom tier.
contact_url:
type: string
description: Sales contact URL for the custom-priced tier.
required:
- id
- name
- tagline
- price
- currency
- limits
- display_features
- recommended
securitySchemes:
BearerAuth:
type: http
scheme: bearer
description: 'API key with `chr_sk_*` for org-level access or `chr_ak_*` for agent-scoped access. Pass in the Authorization header: `Authorization: Bearer chr_sk_...`'
SessionAuth:
type: apiKey
in: cookie
name: chronary_session
description: Console session JWT (HS256), issued by sign-in and sent as the `chronary_session` cookie (a Bearer JWT is also accepted). This is NOT a chr_sk_*/chr_ak_* API key — API keys are rejected with 401 on these endpoints.
x-agent-self-signup:
url: https://api.chronary.ai/v1/agent/sign-up
verify_url: https://api.chronary.ai/v1/agent/verify
restricted_key_returned: true
human_in_the_loop: otp_email
rate_limit: 5 requests per 60s per client IP
x-agent-bootstrap-script:
npx: npx @chronary/agent-init@latest
shell: https://chronary.ai/agent-init.sh
description: One-liner that performs sign-up, prompts for OTP, verifies, and creates a smoke calendar. Accepts CHRONARY_EMAIL and CHRONARY_OTP env vars for non-interactive flows.
x-llms-txt: https://docs.chronary.ai/llms.txt
x-llms-full-txt: https://docs.chronary.ai/llms-full.txt
x-mcp-server-card: https://chronary.ai/.well-known/mcp/server-card.json
x-api-catalog: https://chronary.ai/.well-known/api-catalog