https://developers.contactivity.io/changelog/ 2026-10-29T00:00:00Z https://developers.contactivity.io/changelog/#2026-10-29-voice-billing 2026-10-29T00:00:00Z <ul> <li><strong>Forwarded calls</strong> are billed per leg: the inbound leg at the number&#39;s inbound rate, the outbound leg at the destination&#39;s rate.</li> <li><strong>Forwards between Contactivity numbers</strong> stay on our network, billed at the <code>programmable_voice_sip</code> rate. Each number in a chain pays its own legs. More than 3 forwards in a row is refused with <code>482 Loop Detected</code>, and nothing is charged.</li> <li><strong>BYOC numbers</strong> go on to their route&#39;s fallback only when you turn it on: <code>fallback: true</code> on the number, or <strong>Use fallback route</strong> in the portal. It is off by default.</li> <li><strong>Recording</strong> is charged per recorded minute when a recording completes. <strong>Storage</strong> is free for 90 days, then charged each month per stored minute.</li> <li><strong>E911</strong> shows as its own line in a number&#39;s monthly price.</li> <li><strong>Ledger</strong> amounts show 4 decimals, rounded up; your balance keeps 6.</li> </ul> <p>See <a href="/guides/billing/">Billing</a> and <a href="/guides/byoc/#numbers">Bring your own carrier</a>.</p> https://developers.contactivity.io/changelog/#2026-10-28-account-tiers 2026-10-28T00:00:00Z <p>Tier 2 now needs only a card and a first payment. Identity verification moves to tier 3, and proof of address is no longer a tier step: some countries still ask for it before you buy their numbers.</p> <div class="table-wrap"><table> <thead> <tr> <th>Tier</th> <th>Needs</th> </tr> </thead> <tbody><tr> <td>1 (sandbox)</td> <td>Verified email. Calls go only to your verified numbers</td> </tr> <tr> <td>2</td> <td>A card and a first payment</td> </tr> <tr> <td>3</td> <td>Identity verification</td> </tr> <tr> <td>4</td> <td>Business verification</td> </tr> </tbody></table></div> <p>Limits per tier are unchanged. International calling still needs tier 3 and an approved request. Accounts keep their current tier. <code>403 kyc_required</code> on starting a caller ID verification now means a sandbox account already has 4 verified numbers.</p> https://developers.contactivity.io/changelog/#2026-10-25-docs-for-agents 2026-10-25T00:00:00Z <p>Every guide is available as Markdown: add <code>.md</code> to its URL. Coding agents can read <code>/llms.txt</code> for an index and <code>/llms-full.txt</code> for every guide in one file. The changelog has an Atom feed at <code>/changelog.xml</code>.</p> https://developers.contactivity.io/changelog/#2026-10-24-voice-products 2026-10-24T00:00:00Z <p>Each call leg is billed as one product: <code>sip_trunking</code>, <code>programmable_voice</code>, <code>programmable_voice_sip</code>, <code>byoc_sip_trunking</code> or <code>byoc_programmable_voice</code>. Legs are billed per 60 seconds, rounded up, unless your agreement says otherwise.</p> <ul> <li>Calls, carrier legs and CDRs have a <code>product</code> field. <code>GET /cdrs</code> filters by <code>product</code>.</li> <li><code>GET /pricing</code> lists prices per product under <code>products</code>.</li> <li><code>GET /pricing/check</code> takes <code>product</code> (default <code>sip_trunking</code>).</li> <li>Usage lines are <code>&lt;product&gt;_inbound</code> and <code>&lt;product&gt;_outbound</code>, replacing <code>voice_inbound</code> and <code>voice_outbound</code>.</li> </ul> <p>See <a href="/guides/billing/#products">Products</a> and <a href="/guides/voice-apps/#pricing">Pricing</a>.</p> https://developers.contactivity.io/changelog/#2026-10-24-verified-numbers 2026-10-24T00:00:00Z <p>Verified caller IDs are renamed to verified numbers across the API:</p> <div class="table-wrap"><table> <thead> <tr> <th>Before</th> <th>Now</th> </tr> </thead> <tbody><tr> <td><code>/caller-ids</code></td> <td><code>/verified-numbers</code></td> </tr> <tr> <td><code>/caller-ids/{caller_id}</code></td> <td><code>/verified-numbers/{verified_number}</code></td> </tr> <tr> <td><code>/caller-ids/verifications</code></td> <td><code>/verified-numbers/verifications</code></td> </tr> <tr> <td><code>caller_ids:read</code>, <code>caller_ids:write</code></td> <td><code>verified_numbers:read</code>, <code>verified_numbers:write</code></td> </tr> <tr> <td><code>403 caller_id_blocked</code></td> <td><code>403 verified_number_blocked</code></td> </tr> <tr> <td><code>409 caller_id_exists</code></td> <td><code>409 verified_number_exists</code></td> </tr> </tbody></table></div> <p>Existing keys keep their access under the new scope names. See <a href="/guides/numbers/#verified-numbers">Verified numbers</a>.</p> https://developers.contactivity.io/changelog/#2026-10-24-ring-strategy 2026-10-24T00:00:00Z <p><code>register</code> trunks take a <code>ring_strategy</code> (<code>ring_all</code>, <code>sequential</code>, <code>round_robin</code>, <code>longest_idle</code>, <code>random</code>) and <code>ring_secs</code>. Set the ring order of credentials with <code>PUT /trunks/{trunk_id}/credentials/order</code> or each credential&#39;s <code>position</code>. See <a href="/guides/trunks-routes/#ring-strategy">Ring strategy</a>.</p> https://developers.contactivity.io/changelog/#2026-10-24-call-quality-source 2026-10-24T00:00:00Z <p>Each leg in a call&#39;s <code>quality</code> has a <code>source</code>: <code>engine</code> when the voice engine measured the leg, <code>relay</code> when the call was relayed without the voice engine, such as most SIP trunk calls. MOS, jitter, packet loss and round-trip time read the same either way. See <a href="/guides/calls/">Calls</a>.</p> https://developers.contactivity.io/changelog/#2026-10-24-byoc 2026-10-24T00:00:00Z <p>Connect your own carrier to send and receive calls through Contactivity: <code>/byoc/carriers</code> with gateways, source IPs, numbers and 911 routing. BYOC calls work from SIP trunks and voice apps and are billed a platform fee per minute, with no phone network rate.</p> <p>Creating or changing carriers and numbers needs account tier 2 (<code>403 tier_required</code>). New scopes: <code>byoc:read</code>, <code>byoc:write</code>. See <a href="/guides/byoc/">Bring your own carrier</a>.</p> https://developers.contactivity.io/changelog/#2026-10-24-account-tiers 2026-10-24T00:00:00Z <p>Accounts move up four tiers as they complete verification steps:</p> <div class="table-wrap"><table> <thead> <tr> <th>Tier</th> <th>Needs</th> </tr> </thead> <tbody><tr> <td>1 (sandbox)</td> <td>Verified email. Calls go only to your verified numbers</td> </tr> <tr> <td>2</td> <td>A card, a first payment and identity verification</td> </tr> <tr> <td>3</td> <td>Proof of address</td> </tr> <tr> <td>4</td> <td>Business verification</td> </tr> </tbody></table></div> <p>Each tier raises calls per second, concurrent calls and spend limits. <code>GET /limits</code> returns the project&#39;s current limits and today&#39;s spend. Calls per second and concurrent calls are account limits: setting <code>cps_limit</code> or <code>session_limit</code> on a trunk is refused. See <a href="/guides/trunks-routes/#limits">Limits</a>.</p> https://developers.contactivity.io/changelog/#2026-10-22-native-api 2026-10-22T00:00:00Z <p>The native API is live under <code>https://api.contactivity.io/v1/projects/{project_id}/...</code>: calls and call actions, recordings, conferences, queues, numbers, SIP trunks and routes, voice apps, flows, billing, events and webhooks.</p> <ul> <li>One API key per project, with scopes per resource. See the <a href="/guides/overview/#authentication">Overview</a>.</li> <li>Prices are money objects: <code>{&quot;amount&quot;: &quot;0.0140&quot;, &quot;currency&quot;: &quot;USD&quot;}</code>.</li> <li>Number search and ordering are part of the native API. See <a href="/guides/numbers/">Numbers</a>.</li> <li>Events and signed webhooks, with a delivery log and error debugger. See <a href="/guides/events/">Events and webhooks</a>.</li> <li>OpenAPI 3.1 spec and SDKs: <code>@contactivity/sdk</code> (Node) and <code>contactivity_sdk</code> (Python).</li> </ul> https://developers.contactivity.io/changelog/#2026-10-22-compat-prefix 2026-10-22T00:00:00Z <p>The Twilio and Telnyx compatible URL layouts are served under <code>/compat/{vendor}</code>. Set your SDK base URL to:</p> <ul> <li>Twilio REST: <code>https://api.contactivity.io/compat/twilio</code></li> <li>Telnyx Call Control v2 and TeXML: <code>https://api.contactivity.io/compat/telnyx/v2</code></li> </ul> <p>The unprefixed layouts (<code>/2010-04-01/...</code>, <code>/v2/...</code>) are no longer served. See <a href="/guides/compat-migration/">Migrating from Twilio or Telnyx</a>.</p>