Swiftcom

• List my numbers, SIMs, and extensions — Returns the phone numbers, caller IDs, verified SIM numbers, PBX extensions, and eSIMs on this Widely seat, with the provider that supplies each and what it can do.
• Search call history — Finds phone calls on this Widely seat by date range, direction, contact name, or number. Returns one row per phone call, with direction, duration, outcome, the identity used, and whether a transcript or recording exists. started_at, ended_at, and created_at are UTC. The matching _local fields use the account timezone, or timezone when you pass an IANA name. Numbers are E.164. remote_number is the other party, including the other leg when the collapsed leg shows this seat's own number on both sid
• Get one call — Returns full detail for one phone call, identified by call_id, including which identity and provider carried it. UTC times stay beside local times. Numbers are E.164. duration_seconds is the call history duration.
• Get a call transcript — Returns stored transcript text already saved for a phone call. Does not start a new transcription. While speaking is still in progress, the status is in_progress. Returns no_transcript only after the conversation has ended with no stored text.
• Get a call recording link — Returns a short-lived streaming link for a recorded phone call. Business plan, and the grant includes recordings.read. duration_seconds is the call history duration, the same number as search_calls and get_call.
• List voicemails — Returns recent voicemails on this seat with caller, time, duration, and transcript text when one is stored.
• Get one voicemail — Returns one voicemail by call_id, including its transcript. include_audio also returns a short-lived audio link on Pro and above.
• Search messages — Searches this user's Widely, SMS, and WhatsApp threads by keyword and date. Returns message text with sender, thread, and source (sms, whatsapp, email, app, or mcp). Support and assistant threads are excluded. Pass source to keep one of those.
• Read a message thread — Returns messages in one thread, oldest first. before is an ISO 8601 cursor for older pages.
• Search contacts — Finds saved contacts on this seat. name and number are separate filters. Set either one, or both. A contact matches every filter that is set. Omit both to match every contact. A number matches saved numbers, including a national form of the same number. Returns names and phone numbers for one page. limit and offset are the page that was applied, and total is the full match count. include_shared_chats is optional. Set it to include each shared chat name and the last message.
• Find shared chats — Finds chats on this seat shared with one person. Set one of contact_id, user_id, or number. contact_id is a saved contact. user_id is the other person's Widely user. A number matches that phone number, including a national form of the same number. Returns one page of chats with the chat name and the last message. limit and offset are the page that was applied, and total is the full match count.
• Send a message — Sends an SMS or a Widely message into an existing thread, or to a phone number, a contact_id, or one saved contact. A name that matches more than one contact is refused. Pass conversation_id for a thread from search_messages, get_thread, or a shared chat. Omit it and pass to. Pro plan. Sending happens on this request.
• Place a call — Rings the user's phones. After one answers, dials the destination into that same conversation. The result shows as an outgoing phone call. The user speaks on it. Pro plan. If no phone answers, the destination is not dialled.
• Read usage — Returns the eSIM data balance and minutes already used on this seat. data_balance is the data wallet balance. Cancelled eSIMs are omitted unless exclude_cancelled is false. company=true covers the whole account on Business.
• See call forwarding — Returns how this seat's numbers are forwarded. Pro plan.
• Change call forwarding — Points a verified number at a business number on this seat, or stops forwarding when forward_to is empty. Pro plan.
• Transcribe a call — Asks Widely to transcribe a recording that has no text yet. Pro plan.
• Call and speak — Dials the number and the assistant handles the errand on the phone. Business plan. Takes a structured brief only (call describe_errand_template for the fields); free text is refused. A bad brief lists every missing and invalid field at once. The assistant introduces itself with the name in the user's Widely AI assistant settings, or brief.assistant_name; with neither the call is refused (set it with set_assistant_name). It agrees only to allowed_commitments, leaves a voicemail by default, and al
• Read the account — Returns the plan, the live wallet balance (the same headline as Home and Wallet), how many people are on the account, how many eSIMs are live, and which setups this seat can run. Wallet fields are amounts and currency only.
• See the phone system — Returns numbers and who answers them, AI receptionists with greeting, knowledge, voice, and languages, press-1 menus, queues, and opening hours with the weekly windows. The owner needs Business for shared phone-system features; queue agents, shared-number users, and direct person targets need Business too. A queue rings only members who are signed in and available.
• List the team — Returns people on this account and pending email invites.
• Search numbers — Find Widely phone numbers available for a country and an optional city, with the monthly price. Use this when a local number is needed. No sign-in. This does not purchase a number.
• Quote a number — Price a Widely phone number for a country, including the monthly amount and whether local calls are included. Use this when a UK, US, Israeli, or other local number is needed. Each number includes 2 simultaneous calls. More come in packs of 10, shared by the account's numbers in the same country; channel_count prices the packs needed for a total such as 15. No sign-in. This does not purchase the number.
• Quote a port — Price moving an existing number onto Widely. Use this when the current number should be kept. The move is not instant. No sign-in. This does not start the move.
• Port status — Returns the current status of a port request. A port is not instant.

Showing the first 25 tools — full list and schemas: Directory API.