{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"product":"Voice v2 (preview)","type":"markdown"},"seo":{"title":"Voice API v2 API Knowing your Sinch account with Programmable Voice | Voice API v2 | Sinch","siteUrl":"https://developers.sinch.com","llmstxt":{"title":"Sinch Developer Documentation","description":"LLMs.txt containing a map of all the documentation files for Sinch.","sections":[{"title":"Numbers API","description":"The Numbers API enables you to search for, view, and activate numbers. It's considered a precursor to other APIs in the Sinch product family. The numbers API can be used in tandem with any of our APIs that perform messaging or calling.","includeFiles":["docs/numbers/**/*.md","docs/numbers/**/*.yaml"],"excludeFiles":["docs/numbers/index.md"]},{"title":"Conversation API","description":"Send and receive messages globally on many popular channels with ease and confidence when using Sinch's Conversation API. Conversation API is the preferred API for sending mobile messages on SMS and other social channels with Sinch. It is a simple API with unified error messages, consistent request payloads, and common webhook payloads that are channel-agnostic.","includeFiles":["docs/conversation/**/*.md","docs/conversation/**/*.yaml"],"excludeFiles":["docs/conversation/index.md"]},{"title":"Voice API","description":"The Voice API works as a big telephony switch. The Voice API handles incoming phone calls (also known as incoming call “legs”), sets up outgoing phone calls (or outgoing call “legs”), and bridges the two. The incoming call leg may come in over a data connection (from a smartphone or web application using the Sinch SDKs) or through a local phone number (from the PSTN network). Similarly, the outgoing call leg can be over data (to another smartphone or web application using the Sinch SDKs) or the PSTN network.","includeFiles":["docs/voice/**/*.md","docs/voice/**/*.yaml"],"excludeFiles":["docs/voice/index.md"]},{"title":"Voice API v2","description":"The Voice API works as a big telephony switch. The Voice API handles incoming phone calls (also known as incoming call “legs”), sets up outgoing phone calls (or outgoing call “legs”), and bridges the two. The incoming call leg may come in over a data connection (from a smartphone or web application using the Sinch SDKs) or through a local phone number (from the PSTN network). Similarly, the outgoing call leg can be over data (to another smartphone or web application using the Sinch SDKs) or the PSTN network.","includeFiles":["docs/voice-2.0/**/*.md","docs/voice-2.0/**/*.yaml"],"excludeFiles":["docs/voice-2.0/index.md"]},{"title":"Verification API","description":"The Verification API is a platform for phone number verification. It consists of the API and different software development kits (the Sinch SDKs) that you integrate with your smartphone or web application and cloud based back-end services. Together they enable SMS, Flashcall, Phone Call and Data verification in your application.","includeFiles":["docs/verification/**/*.md","docs/verification/**/*.yaml"],"excludeFiles":["docs/verification/index.md"]},{"title":"Provisioning API","description":"Provisioning API allows you to programmatically set up your senders, accounts and templates on your favorite messaging platforms on the Conversation API. For now, you can create your first WhatsApp channel through Meta's Embedded sign up, you can configure your first SMS App and configure your webhooks. As development continues, we will be adding the most commonly used channels.","includeFiles":["docs/provisioning-api/**/*.md","docs/provisioning-api/**/*.json"],"excludeFiles":["docs/provisioning-api/index.md"]},{"title":"Elastic SIP Trunking API","description":"With Elastic SIP Trunking you can create and manage your SIP trunks and phone numbers programmatically.","includeFiles":["docs/est/**/*.md","docs/est/**/*.yaml"],"excludeFiles":["docs/est/index.md"]},{"title":"Fax API","description":"Send and receive HIPAA compliant faxes on our modern fax platform using our developer-friendly API.","includeFiles":["docs/fax/**/*.md","docs/fax/**/*.yaml"],"excludeFiles":["docs/fax/index.md"]},{"title":"In-app Voice and Video SDK","description":"The In-app Voice and Video SDK enables you to add voice and video calling capabilities directly into your mobile or web application using the Sinch SDKs.","includeFiles":["docs/in-app-calling/**/*.md"],"excludeFiles":["docs/in-app-calling/index.md"]},{"title":"Number Lookup API","description":"The Number Lookup API is designed to provide in-depth information about phone numbers, helping enterprises enhance their communication strategies and prevent fraud. By identifying the type of phone line (for example, mobile, landline, VoIP) and the associated carrier, the API allows businesses to optimize routing, reduce unnecessary costs, and improve customer engagement.","includeFiles":["docs/number-lookup-api-v2/**/*.md","docs/number-lookup-api-v2/**/*.yaml"],"excludeFiles":["docs/number-lookup-api-v2/index.md"]},{"title":"Functions","description":"Serverless compute for voice and messaging. Deploy your code and Sinch routes live calls and messages to it — no infrastructure to run.","includeFiles":["docs/functions/functions/**/*.md","docs/functions/concepts/**/*.md","docs/functions/reference/**/*.md"],"excludeFiles":["docs/functions/functions/index.md"]},{"title":"CLI","description":"One command line for every Sinch API and the full Functions lifecycle — scaffold, run locally, deploy, and manage.","includeFiles":["docs/functions/cli/**/*.md"],"excludeFiles":["docs/functions/cli/index.md"]}]},"description":"Understand the different types of accounts, resources and limitations."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"knowing-your-sinch-account-with-programabled-voice","__idx":0},"children":["Knowing your Sinch account with Programabled Voice"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-types","__idx":1},"children":["Account types"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"self-created","__idx":2},"children":["Self created"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a customer creates a new Sinch account via ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.sinch.com/signup"},"children":["Sinch Build Dashboard"]},", they will receive test credits, these can be used to make and receive calls, you can also use it to test all our voice features (recording, tts, AMD..) and channels (SIP, Streams, VoiceRelay...)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"enterprise","__idx":3},"children":["Enterprise"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For enterprise customers, please contact our sales teams, they can setup a new account for you with special conditions."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note:"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Self created accounts can be converted to enterprise by Sinch, but in many cases, the easier path if you started as self created is just to request a new account from sales, you will be able to set credit limits and eventualy special prices."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Also Enterprise accounts can be POSTPAID or PREPAID, Self created accounts are always PREPAID"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Note:"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Our Programmable Voice product does not require provisioning.Once you have your account, you can just use it!"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-status","__idx":4},"children":["Account status"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"trial-vs-upgraded","__idx":5},"children":["Trial vs Upgraded"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All self created accounts start as trial, and they are initially limited! Once the account is upgraded by adding a payment method and credits, the account limitations are reduced, which will enable the complete potential of the Programable Voice product."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"trial-account-limitations","__idx":6},"children":["Trial account limitations:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Users cannot buy numbers, nevertheless, during the first 2 weeks of the trial period, customers will receive a voice enabled test number, which allow the reception of calls (Inbound PHONE calls)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Users can only DIAL (Outbound PHONE calls) to verified numbers, the phone number used to create the account is automatically verified, but under the Numbers menu, users can add new real numbers they own, each new number will be verified, if the verification process is successful, the account will be allowed to call these numbers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Users can only initiate one PHONE call at a time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["and calls will be limited to few minutes."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Once the amount of free credits is consumed, users of self created account will need to upgrade or contact Sinch sales team."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once the first payment is done, the account becomes an Upgraded account, with little to no limitations. Sinch uses internal mechanisms to evaluate account usage in order to prevent or interrupt fraudulent uses cases. As your relationship with Sinch evolves, so your accounts permisisons."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note:"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Entreprise accounts can also be created as trial, the same limitations apply, but usually the amount of test credits is bigger"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"upgraded-accounts","__idx":7},"children":["Upgraded accounts"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Accounts created by Sinch's sales team, are always Entreprise type, and they can be set as PREPAID, POSTPAID, Upgraded or Trial."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"summary","__idx":8},"children":["Summary"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Account type"},"children":["Account type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Created by"},"children":["Created by"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Account status"},"children":["Account status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Limited"},"children":["Limited"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Payment type"},"children":["Payment type"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Self created"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Trial"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PREPAID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Self created"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Upgraded"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PREPAID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enterprise"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sinch"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Upgraded"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POSTPAID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enterprise"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sinch"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Upgraded"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PREPAID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enterprise"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sinch"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Trial"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PREPAID"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sandbox-vs-production","__idx":9},"children":["Sandbox vs Production"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When we talk about real PSTN (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["P"]},"ublic ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["S"]},"witched ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["T"]},"elephony ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["N"]},"etwork) calls, the concept of Sandbox doesn't really apply, as any real PSTN calls must reach the real network, generating real traffic and costs, we should also consider the regulatory implications of un-registered users making real calls. To solve this issue, we have granted test credits, allowing PSTN calls to registered numbers, we have also provided a free test number that allow customers to receive PSTN calls to test our phone quality and webhooks behavior."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Regarding testing, customer can implement SIP or In-app calling, Inbound and Outbound test scenarios, that will enable full webhook and API integration and testing, with minimal costs. Use our test credits for that!"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Regading CI/CD. Sinch can provide extra test credits to Enterprise customers during the integration and evaluation periods, after that, CI/CD pipelines that generate real traffic, are considered regular usage of the platform, therefore are treated as production traffic. It is worth to reinforce, that Sinch has a pay-as-Go charging model, which make the such recurrent test process very inexpensive, assuming basic calling funcionalities are used, ie: not calling expensive destinations, extremely long calls or stress and load testing, which can become expensive if not managed carefullly as it is rea traffic."]}]}]}]},"headings":[{"value":"Knowing your Sinch account with Programabled Voice","id":"knowing-your-sinch-account-with-programabled-voice","depth":1},{"value":"Account types","id":"account-types","depth":2},{"value":"Self created","id":"self-created","depth":3},{"value":"Enterprise","id":"enterprise","depth":3},{"value":"Account status","id":"account-status","depth":2},{"value":"Trial vs Upgraded","id":"trial-vs-upgraded","depth":3},{"value":"Trial account limitations:","id":"trial-account-limitations","depth":4},{"value":"Upgraded accounts","id":"upgraded-accounts","depth":4},{"value":"Summary","id":"summary","depth":2},{"value":"Sandbox vs Production","id":"sandbox-vs-production","depth":2}],"frontmatter":{"seo":{"title":"Voice API v2 API Knowing your Sinch account with Programmable Voice | Voice API v2 | Sinch","description":"Understand the different types of accounts, resources and limitations."}},"lastModified":"2026-08-31T13:48:15.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/voice-2.0/accounts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}