Widely

Returns one Errands task: status, quote, collected facts, and recent events.

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 an indicative monthly phone-number price for a country, using this account's rate checker.

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

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

Returns notification toggles and the low-balance threshold.

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

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

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

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

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

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 the eSIM data balance and minutes already used on this seat. company=true covers the whole account on Business.

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

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

Lists this seat's Errands tasks. Filter by status or date.

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

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.

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

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 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.

Returns people on this account and pending email invites.

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

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

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 the documents a number port needs. No sign-in. Does not submit a port.

Returns the per-minute price for dialling a destination number or country. Signed in, it is this account's rate (account_rate true). Not signed in, it is the public list price (list_price true). This does not place the call.

Prices an Errands brief from the call rate sheet, including the ai_task minute. Returns the caller ID and the cost at max_call_minutes. No rate refuses the call. Emergency and premium-rate numbers are refused. A marketing brief is refused. The seat needs the current Errands terms. A bad brief lists every missing and invalid field at once. This does not dial.

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.

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.

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.

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 messages in this user's Support chat, oldest first. Any connected account can read it. Other chats are not included.

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.

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 always ends with a thank-you and goodbye. Returns immediately with the task and call ids.

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

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.

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.

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

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

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.

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.

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

Sets the name the assistant uses on AI calls (Widely AI assistant settings → Assistant's name). Calls are refused until a name is set or passed in the brief.

Sets what happens when this seat declines a call, does not answer it, or is busy: voicemail, busy, decline, end, or ai_receptionist. ai_receptionist rings the seat first, then hands the call to the AI receptionist or phone menu in menu_id (Business).

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.

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 the UK shared Always-forward destination and the dial code. No sign-in.

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

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

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.

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 an AI receptionist. The account owner needs Business. It speaks with the caller and does not transfer the live conversation to a person.

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

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

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