SayWordy for developers

Different languages.
One connection.

Add translated phone conversations to your product. Check the rate, connect two people and follow the conversation with one prepaid balance.

Manage API keys See how it works ↓

Phone-to-phone calling · Supported US destinations · Server-side API

01QuoteKnow the price

02ConnectAccept, then dial

03TranslateFollow the call

A straightforward beginning

Quote. Call. Stay in the loop.

Keep keys on your server.
Your users stay in control of every call.

curl https://saywordy.com/api/v1/quotes \
  -H "Authorization: Bearer $SayWordy_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": {
      "you": {"phoneNumber": "+12025550101", "language": "en", "voice": "female"},
      "them": {"phoneNumber": "+12025550102", "language": "es", "voice": "male"},
      "recording": false,
      "hearOriginal": true
    }
  }'

The example phone numbers are reserved for documentation. Replace them only when you intend to make a real, paid call. Use a test key for simulated requests. Test mode never dials or charges your balance. A quote never starts a call.

Try the flow

A preview, without the phone ringing.

Run this local example to see what a price check feels like. It uses a fictional 30-credit rate and makes no API requests, lookups or phone calls.

Your example quote will appear here.

No API key needed.

Keys with boundaries.

Create scoped keys with a spending limit. Revoke access from your account. Never put a secret key in browser or mobile client code.

One source of truth.

The accepted server quote sets the call price. Connected seconds draw from the same wallet you use on SayWordy.

Built around consent.

Both participants accept before connecting. Recording is optional and requires both people’s agreement. Failed setup has no conversation charge.

What to expect from the API

Authentication: Authorization: Bearer YOUR_KEY. Keys are scoped to their workspace and authorized calls.
Quotes: Check both numbers before calling. A quote includes its expiry and rate. Changed numbers or expired quotes require a fresh check.
Retries: Use a unique idempotency key for each intended call, and reuse that key when retrying the same request.
Usage: Both phone connections and translation are included in the accepted per-minute rate. Charging uses connected seconds and fractional credits.
Availability: Access depends on your account, configured routes and available credits. Unknown, premium and unsupported destinations cannot be called.

Where we want to go next

One wallet. More ways to connect.

Direct browser and native app calls, video and meeting integrations are on our roadmap. They are not currently available through this API.

Explore pricing

Different languages.One connection.