KaiCalls Agency Billing Periods API
The Agency Billing Periods API from KaiCalls — 1 operation(s) for agency billing periods.
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/kaicalls-com:kaicalls-com-agency-billing-periods-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: KaiCalls Public Agency Billing Periods API
version: '2026-06-05'
description: Machine-readable surface for KaiCalls external developers and client agents.
servers:
- url: https://www.kaicalls.com/api
security:
- bearerAuth: []
tags:
- name: Agency Billing Periods
paths:
/v1/agency-billing-periods:
get:
summary: Read authorized agency billing-periods
description: Verified agency scope and current canonical client membership apply. Private lists are bounded and never expose link tokens or connection secrets.
parameters:
- in: query
name: partnerId
schema:
type: string
format: uuid
- in: query
name: after
schema:
type: string
format: uuid
responses:
'200':
description: Scoped current state and page cursor where applicable.
'403':
description: Current membership or scope required.
'503':
description: Evidence unavailable; never reported as zero.
x-required-scopes: billing:read
tags:
- Agency Billing Periods
operationId: getV1AgencyBillingPeriods
x-operation-id-source: derived
post:
summary: Manage agency billing-periods using a strict reviewed command
description: IDs are in the body. Runtime refinements, current role, assignment and exact approval/hash/lease guards apply. Enrollment creation and commit require a stable Idempotency-Key. Installation run_scenarios also requires evals:write. Care requires sms:write and exact owner approval; preparation creates a draft, launch explicitly queues it. Provider-unknown outcomes require reconciliation. Configuration, testing, activation, billing and measured outcomes are distinct.
parameters:
- in: header
name: Idempotency-Key
schema:
type: string
maxLength: 150
requestBody:
required: true
content:
application/json:
schema:
oneOf:
- type: object
properties:
action:
const: retry_collection
type: string
partnerId:
type: string
format: uuid
periodId:
type: string
format: uuid
required:
- action
- partnerId
- periodId
additionalProperties: false
- type: object
properties:
action:
const: record_adjustment
type: string
partnerId:
type: string
format: uuid
lineId:
type: string
format: uuid
amountCents:
type: integer
minimum: -100000000
maximum: 100000000
reason:
type: string
minLength: 1
maxLength: 500
providerCreditNoteId:
type: string
maxLength: 200
providerDebitInvoiceId:
type: string
maxLength: 200
required:
- action
- partnerId
- lineId
- amountCents
- reason
additionalProperties: false
- type: object
properties:
action:
const: set_plan
type: string
partnerId:
type: string
format: uuid
businessId:
type: string
format: uuid
plan:
anyOf:
- type: string
maxLength: 100
- type: 'null'
required:
- action
- partnerId
- businessId
- plan
additionalProperties: false
- type: object
properties:
action:
const: set_automatic_collection
type: string
partnerId:
type: string
format: uuid
accepted:
type: boolean
required:
- action
- partnerId
- accepted
additionalProperties: false
- type: object
properties:
action:
const: publish_terms
type: string
partnerId:
anyOf:
- type: string
format: uuid
- type: 'null'
title:
type: string
minLength: 1
maxLength: 200
discountBps:
type: integer
minimum: 0
maximum: 9900
graceDays:
type: integer
minimum: 0
maximum: 90
document:
type: string
minLength: 20
maxLength: 20000
effectiveFrom:
type: string
format: date-time
required:
- action
- partnerId
- title
- discountBps
- graceDays
- document
- effectiveFrom
additionalProperties: false
- type: object
properties:
action:
const: accept_terms
type: string
partnerId:
type: string
format: uuid
termsId:
type: string
format: uuid
required:
- action
- partnerId
- termsId
additionalProperties: false
- type: object
properties:
action:
const: setup_collection
type: string
partnerId:
type: string
format: uuid
offerId:
type: string
format: uuid
required:
- action
- partnerId
additionalProperties: false
- type: object
properties:
action:
const: freeze_period
type: string
partnerId:
type: string
format: uuid
start:
type: string
format: date-time
end:
type: string
format: date-time
required:
- action
- partnerId
- start
- end
additionalProperties: false
- type: object
properties:
action:
const: collect
type: string
partnerId:
type: string
format: uuid
periodId:
type: string
format: uuid
required:
- action
- partnerId
- periodId
additionalProperties: false
responses:
'200':
description: Recorded command receipt; read back current evidence.
'202':
description: Enrollment per-client receipt; inspect waiting and conflict states.
'400':
description: Invalid command.
'403':
description: Authority or approved owner revision required.
'409':
description: State changed or provider reconciliation required.
'503':
description: Dependency unavailable; durable operation retained.
x-required-scopes: billing:write
tags:
- Agency Billing Periods
operationId: postV1AgencyBillingPeriods
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'KaiCalls API key. Per-operation scope requirements are published on each operation as `x-required-scopes` — a scope string, or a nested `{ allOf: [...] }` / `{ anyOf: [...] }` expression. An operation with no `x-required-scopes` requires a valid key but no particular scope.'
x-scopes:
- workspaces:read
- workspaces:write
- numbers:read
- numbers:write
- agents:read
- agents:write
- communication-runs:read
- communication-runs:write
- calls:read
- calls:write
- sms:read
- sms:write
- webhooks:read
- webhooks:write
- events:read
- events:replay
- lifecycle:write
- leads:read
- leads:write
- emails:read
- emails:write
- sdr:read
- sdr:write
- evals:read
- evals:write
- appointments:read
- appointments:write
- knowledge:read
- knowledge:write
- products:read
- products:write
- integrations:write
- approvals:write
- concierge:write
- billing:read
- billing:write
- call_evidence:read
- call_evidence:write
- support:write
sessionAuth:
type: apiKey
in: cookie
name: sb-access-token
description: Authenticated dashboard session cookie. Used by first-party flows that mint or manage API keys.