> ## Documentation Index > Fetch the complete documentation index at: https://docs.formitto.com/llms.txt > Use this file to discover all available pages before exploring further. # List calendar widgets ## OpenAPI ````yaml /api/openapi.yaml get /calendar-widgets openapi: 3.1.0 info: title: Formitto API version: 1.0.0 description: > The Formitto public API (v1). Read and manage your forms, submissions, calendars, bookings, shop widgets, and orders programmatically. Authenticate with an API key created in the Formitto dashboard (Settings → API keys). Pass it as a Bearer token: `Authorization: Bearer fmt_live_...`. Keys are scoped — a key only reaches the endpoints its scopes allow (e.g. `read:forms`, `write:submissions`). All responses are JSON. List endpoints return a `{ data, pagination }` envelope; single-resource endpoints return the object directly. Requests are rate-limited per API key; see the `X-RateLimit-*` response headers. contact: name: Formitto Support url: https://formitto.com license: name: Proprietary url: https://formitto.com/terms servers: - url: https://formitto.com/v1 description: Production security: - bearerAuth: [] tags: - name: forms description: Create, read, update, and archive forms. - name: submissions description: Read and programmatically ingest form submissions. - name: calendars description: Read calendar widgets. - name: bookings description: Read calendar bookings. - name: ecommerce description: Read shop widgets. - name: orders description: Read shop orders. - name: webhooks description: Manage event subscriptions (REST Hooks) for integrations. paths: /calendar-widgets: get: tags: - calendars summary: List calendar widgets operationId: listCalendarWidgets parameters: - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/Limit' - $ref: '#/components/parameters/DomainId' responses: '200': description: A page of calendar widgets. headers: X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: type: object required: - data - pagination properties: data: type: array items: $ref: '#/components/schemas/CalendarWidget' pagination: $ref: '#/components/schemas/PaginationMeta' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/ServerError' components: parameters: Page: name: page in: query description: 1-based page number. required: false schema: type: integer minimum: 1 default: 1 Limit: name: limit in: query description: Items per page (max 100). required: false schema: type: integer minimum: 1 maximum: 100 default: 25 DomainId: name: domainId in: query description: Narrow results to a specific registered domain id. required: false schema: type: integer headers: RateLimitLimit: description: The per-API-key request budget for the current 1-hour window. schema: type: integer RateLimitRemaining: description: Requests remaining in the current window after this request. schema: type: integer RateLimitReset: description: Unix timestamp (seconds) at which the rate-limit window resets. schema: type: integer RetryAfter: description: Seconds to wait before retrying. Present on 429 responses. schema: type: integer schemas: CalendarWidget: type: object required: - id - name - createdAt - updatedAt properties: id: type: integer name: type: string domain: oneOf: - $ref: '#/components/schemas/DomainRef' - type: 'null' bookingCount: type: integer description: Present on list responses. settings: type: object description: Widget settings (webhookUrl stripped). Present on the detail view. additionalProperties: true appearance: type: object description: Present on the detail view. additionalProperties: true behavior: type: object description: Present on the detail view. additionalProperties: true createdAt: type: string format: date-time updatedAt: type: string format: date-time PaginationMeta: type: object required: - page - limit - total - pages properties: page: type: integer description: Current 1-based page. limit: type: integer description: Items per page. total: type: integer description: Total matching items. pages: type: integer description: Total page count. DomainRef: type: object description: The registered domain a resource is bound to. required: - id - domain properties: id: type: integer domain: type: string examples: - example.com Error: type: object description: > Standard error envelope. `code` is a stable machine-readable string (e.g. invalid_api_key, insufficient_scope, not_found, rate_limited, domain_required, forbidden_field). Some errors carry extra context fields (candidates, required, fields, invalid, retryAfter). required: - error additionalProperties: true properties: error: type: string description: Human-readable message. code: type: string description: Stable machine-readable error code. responses: Unauthorized: description: The API key is missing, malformed, revoked, or expired. content: application/json: schema: $ref: '#/components/schemas/Error' Forbidden: description: The API key is valid but lacks the scope this endpoint requires. headers: X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: $ref: '#/components/schemas/Error' RateLimited: description: The per-API-key request budget for the current window is exhausted. headers: X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/Error' ServerError: description: An unexpected server error. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: fmt_live_* description: > A Formitto API key created in the dashboard (Settings → API keys). Pass it as `Authorization: Bearer fmt_live_...`. ````