Widely

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.

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.

Returns full detail for one phone call, identified by call_id, including which identity and provider carried it.

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.

Returns a short-lived streaming link for a recorded phone call. Business plan, and the grant includes recordings.read.

Returns recent voicemails on this seat with caller, time, duration, and transcript text when one is stored.

Returns one voicemail by call_id, including its transcript. include_audio also returns a short-lived audio link on Pro and above.

Searches this user's Widely, SMS, and WhatsApp threads by keyword and date. Returns message text with sender and thread. Support and assistant threads are excluded.

Returns messages in one thread, oldest first. before is an ISO 8601 cursor for older pages.

Finds saved contacts on this seat by name. Returns names and phone numbers.

Sends an SMS or a Widely message to a phone number or saved contact. Pro plan. Sending happens on this request.

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.

Returns the eSIM data balance and minutes already used on this seat. company=true covers the whole account on Business.

Returns how this seat's numbers are forwarded. Pro plan.

Points a verified number at a business number on this seat, or stops forwarding when forward_to is empty. Pro plan.

Asks Widely to transcribe a recording that has no text yet. Pro plan.

Dials the number and the assistant handles the task on the phone. Business plan. The user's own phones stay quiet unless connect_user is true. Returns immediately with call_id. An empty transcript means speaking is still in progress. connect_user true asks the person to hold, rings the user's phones into the same conversation, and the assistant leaves.

Returns shared numbers and phone menus. This user and the account owner need Business.

Returns the plan, wallet balance, how many people are on the account, how many eSIMs are live, and which setups this seat can run.

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.

Returns people on this account and pending email invites.

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.

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 n

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.

Returns the current status of a port request. A port is not instant.

Price Widely travel data for a country. Use this when a trip needs data and not a home mobile service. Pay as you go per GB, with no data package. An optional gb value returns an estimate billed in 0.1 GiB steps. No sign-in.

Find a home mobile service Widely can provide for a country, including eSIM or physical SIM, native voice, SMS, a mobile number, and a regular or kosher line when the offer includes it. No sign-in. An empty list means nothing is listed yet. Travel data for a trip is a separate Widely product.

Price one listed home mobile service for a form factor and number line that offer allows. The amount comes from that offer. No sign-in. This is separate from Widely travel data.

Returns the price for dialling a destination number or country. No sign-in. This does not place the call.

List Free, Pro, and Business monthly prices. Each monthly figure is per user. Quote that amount. Do not round it and do not call it an account price. No sign-in. This does not change the plan. Business covers the office phone system. channel_packs lists the 10-channel pack prices: number packs per country, and SIP trunk packs per account.

Emails an invitation to join this Widely account. New users start Free; there is no account user limit.

Creates or edits an AI receptionist. The account owner needs Business. It speaks with the caller and does not transfer the live conversation to a person.

Pause, resume, choose who can see the WhatsApp chats, or set the webhook that answers first. Setting a webhook returns the signing secret once.

Adds or revises a knowledge entry for one receptionist. The next WhatsApp reply and the next phone call both use it.

Returns one receptionist's profile, contacts, locations, opening hours, and categorized business facts before you update them.

Creates or edits the business identity, IANA timezone, contact details, and human-escalation instructions used on phone and WhatsApp.

Stores a business address plus directions, parking, public transport, accessibility, location contacts, coordinates, and timezone.

Deletes one structured location from a receptionist.

Deletes one categorized service, price, policy, FAQ, inventory, returns, donation, escalation, or custom fact.

Stops one receptionist from using its informational opening-hours schedule. It does not change DID open/closed routing.

Creates or edits a press-1 menu. The account owner needs Business. A key can ring a person, ring a queue, or send the caller to an AI receptionist. A direct person target and every queue agent also need Business.

Creates or edits a queue. The account owner and every queue member need Business. A queue rings only members who are signed in and available.

Creates or edits a timezone-aware opening-hours schedule and optionally attaches it to an AI receptionist. Informational receptionist hours do not change DID routing. day is 0 for Monday through 6 for Sunday; start and end are HH:MM. Date-bounded is_closed windows are exceptions.

Points a number at ring_me, personal_assistant, a receptionist, a menu, a queue, voicemail, busy, or decline. An optional closed target uses the opening hours. A shared line, receptionist, menu, or queue needs Business.

Sends Widely a note about a missing capability, a complaint, or a use case to build. No account is required. reply_url, when it is https, receives each desk reply. Returns conversation_id. Passing that id on a later request adds to the same thread.

Returns one product-note thread by conversation_id, oldest first. No account is required. Does not list other threads.

Sets the https URL that receives call.started, call.ended, and speak.completed for this seat. events chooses which of those names to receive. Omitting events receives all three. An empty webhook_url stops delivery.

Returns public product facts and in-app menu names for a question. No sign-in. Does not return a price.

Returns the UK shared Always-forward destination and the dial code. No sign-in.

Returns the ways a customer stops charges without closing the account (cancel membership, stop a number renewing, remove a saved card) and that unused credit is refunded on closure. Full deletion is handled by Widely Support; no deletion steps. No sign-in.

Former name, kept for existing connections. Returns the ways a customer stops charges without closing the account (cancel membership, stop a number renewing, remove a saved card) and that unused credit is refunded on closure. Full deletion is handled by Widely Support; no deletion steps. No sign-in.

Returns the documents a number port needs. No sign-in. Does not submit a port.

Returns the eSIM install path and the APN. The APN is null when this profile has no APN. No sign-in.

Returns the live wallet total for this seat, the same headline as Home and Wallet. The response has no spendable or reserved breakdown.

Returns the wallet ledger of top-ups, product debits, and holds. Each row includes the customer label.

Returns charges already on this account, with amounts and labels. An empty list means there is no matching charge.

Returns masked saved cards and bank methods: brand, last4, and default. A processor id is not included.

Returns this customer's pay-as-you-go data ladder, starting from data already used this period. This is the account rate, separate from the public shelf. Omitting gb returns the volume points.

Returns the per-minute rate to a destination country or number for this account. The rate depends on the destination.

Returns an indicative monthly phone-number price for a country, using this account's rate checker.

Returns this account's phone numbers, including numbers that stay inactive until identity registration is finished.

Returns first-eSIM wallet top-ups that can be refunded to the card: the profile has not been installed and the top-up is inside the refund window.

Returns whether auto top-up is on, and the threshold and amount.

Returns notification toggles and the low-balance threshold.

Asks this user's Widely app to check the eSIM and returns a request_id. A result of no_install_yet means the profile may have been installed from a QR and the Widely app is not on that phone. An APN is not included.

Returns the result of an eSIM connection check for request_id, including fail and warn items. Phone settings are not changed.

Writes a message into this user's Support chat for a person to read. Any connected account can send it. Support's own assistant does not answer this message. text is what is needed and what was already tried.

Returns messages in this user's Support chat, oldest first. Any connected account can read it. Other chats are not included.