call4me Call4me API

openapi: 3.2.0
info:
  title: Call4me API
  version: 1.3.0
  description: 'Phone calls an AI agent places for its user: call a business, follow the call to its outcome, answer the caller''s questions mid-call, and patch the user in. Also the prepaid balance, the caller profile, scheduled calls, the account''s phone numbers and call recordings. The same operations as the MCP server at /mcp. Calls are billed per minute from pickup (phone menus and conversation; hold time at half price) from the prepaid balance; unanswered calls are free. Refusals name MCP tools (call4me_place_call is POST /api/calls, call4me_save_profile is PATCH /api/profile).'
  x-guidance: 'With a wallet and no account: POST /api/x402/calls with the call (to, business, goal, category, details, on_behalf_of, max_minutes) and pay the 402 in USDC on Base. A refusal (422 "Not calling yet") lists what to ask the user and takes no payment. The paid response returns the call id and an api_key; follow the call with GET /api/calls/{call_id}?wait_seconds=30 and Authorization: Bearer <api_key> until finished, answering open questions with POST /api/calls/{call_id}/answer. With an account: the bearer routes below, and GET /api to buy credits in USDC.'
  contact:
    name: call4me
    email: me@call4.me
    url: https://call4.me
servers:
- url: https://call4.me
tags:
- name: Call4me API
paths:
  /api:
    get:
      operationId: buyCredits
      description: 'Buy call credits in USDC on Base over x402 for the account named by the bearer token. Without a payment: 402 with the price of `amount` dollars of credits.'
      security:
      - bearerAuth: []
      parameters:
      - name: amount
        in: query
        required: false
        description: dollars of credits, 10 to 500 (default 10)
        schema:
          $schema: https://json-schema.org/draft/2020-12/schema
          type: number
          minimum: 10
          maximum: 500
      x-payment-info:
        price:
          mode: dynamic
          currency: USD
          min: '10.00'
          max: '500.00'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Credited
          content:
            application/json:
              schema:
                $schema: https://json-schema.org/draft/2020-12/schema
                type: object
                properties:
                  credited:
                    type: string
                  credited_cents:
                    type: number
                  balance:
                    type: string
                  balance_cents:
                    type: number
                  transaction:
                    type: string
                  payer:
                    type: string
                required:
                - credited
                - credited_cents
                - balance
                - balance_cents
                - transaction
                - payer
                additionalProperties: {}
        '400':
          description: Request failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '401':
          description: Request failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
        '402':
          description: 'Payment required: the x402 v2 requirements, also in the PAYMENT-REQUIRED header'
          content:
            application/json:
              schema:
                type: object
                properties:
                  x402Version:
                    type: integer
                  accepts:
                    type: array
                    items:
                      type: object
                required:
                - x402Version
                - accepts
        '503':
          description: Request failed
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                - error
      tags:
      - Call4me API
      summary: Buy credits
      x-summary-source: derived
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: A call4me API key or OAuth access token for the site or MCP resource.