call4me Profile API
The Profile API from call4me — 1 operation(s) for profile.
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/call4-me:call4-me-profile-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: call4me Profile 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: Profile
paths:
/api/profile:
get:
operationId: getProfile
description: Saved details reused on relevant calls (name, DOB, phone, address, insurance, car). An incomplete profile is fine. Free.
security:
- bearerAuth: []
responses:
'200':
description: The saved profile
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
profile:
type: object
propertyNames:
type: string
additionalProperties:
type: string
missing:
type: array
items:
type: string
required:
- profile
additionalProperties: {}
'401':
description: Request failed
content:
application/json:
schema:
type: object
properties:
error:
type: string
required:
- error
tags:
- Profile
summary: Get profile
x-summary-source: derived
patch:
operationId: saveProfile
description: Save facts that are the same on every call. Merges into what is saved; an empty string removes a field. Save only what the user agreed to keep.
security:
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
full_name:
description: full name
type: string
maxLength: 500
name_pronunciation:
description: name pronunciation
type: string
maxLength: 500
assistant_name:
description: assistant name
type: string
maxLength: 500
accent:
description: caller accent
type: string
maxLength: 500
answering_instructions:
description: answering instructions
type: string
maxLength: 500
date_of_birth:
description: date of birth
type: string
maxLength: 500
phone:
description: phone number
type: string
maxLength: 500
email:
description: email
type: string
maxLength: 500
address:
description: home address
type: string
maxLength: 500
insurance_carrier:
description: health insurance carrier
type: string
maxLength: 500
insurance_member_id:
description: health insurance member ID
type: string
maxLength: 500
insurance_group_number:
description: health insurance group number
type: string
maxLength: 500
dental_insurance_carrier:
description: dental insurance carrier
type: string
maxLength: 500
dental_insurance_member_id:
description: dental insurance member ID
type: string
maxLength: 500
vehicle:
description: vehicle (year, make, model, mileage)
type: string
maxLength: 500
vin:
description: VIN
type: string
maxLength: 500
frequent_flyer_numbers:
description: frequent flyer numbers
type: string
maxLength: 500
known_traveler_number:
description: Known Traveler Number (TSA PreCheck / Global Entry)
type: string
maxLength: 500
redress_number:
description: TSA Redress number
type: string
maxLength: 500
additionalProperties: false
responses:
'200':
description: The profile now saved
content:
application/json:
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
profile:
type: object
propertyNames:
type: string
additionalProperties:
type: string
missing:
type: array
items:
type: string
required:
- profile
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
tags:
- Profile
summary: Save profile
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.