Introduction

Dive into our full API Reference Documentation and seamlessly integrate Voice and SMS functionalities into your website or application. This API uses HTTP verbs and a RESTful endpoint structure. Your Account SID and Auth Token is used as the API Authorization framework. Request and response payloads are formatted as JSON using UTF-8 encoding and URL encoded values.

Make an HTTP Request

There are a lot of ways you can make an HTTP request to Somleng. You can use a Helper Library or SDK for your preferred programming language or you can make a raw HTTP request in your code by using a tool like Postman.

Credentials

All requests to Somleng need to be authenticated. Somleng using HTTP basic auth, which use the following username/password schemes:

Account SID and Auth Token

The account SID and auth token are the master keys to your account.

Username	Password
AccountSid	AuthToken

Store Your Somleng Credentials Securely

It's important to keep credentials such as your Somleng Account SID and Auth token secure by storing them in a way that prevents unauthorized access. One common method is to store them in environment variables which are then accessed from your app. This keeps them out of code and other places where credentials don't belong.

On the right is an example in Node.js ---->

const accountSid = process.env.SOMLENG_ACCOUNT_SID;
const authToken = process.env.SOMLENG_AUTH_TOKEN;
const client = require('somleng')(accountSid, authToken);

// Make API calls here...

Helper Libraries

The following is a list of officially supported helper libraries for Somleng. Please refer to the documentation in each library for more details.

somleng-node

Demo Applications

The following is a list of demo applications which you can use to get started with Somleng.

Somleng Demo Next.js

Accounts

01. Fetch an account

Returns a representation of an account, including the properties above.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/73764e5c-99dd-4ebd-ae8b-f8b8234fd11e" \
    -u 73764e5c-99dd-4ebd-ae8b-f8b8234fd11e:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:Sid

GET https://api.somleng.org/2010-04-01/Accounts/73764e5c-99dd-4ebd-ae8b-f8b8234fd11e

Parameters

Name	Description
Sid	Path Parameter: The Account Sid that uniquely identifies the account to fetch.

Response


200 OK

{
  "api_version": "2010-04-01",
  "sid": "73764e5c-99dd-4ebd-ae8b-f8b8234fd11e",
  "date_created": "Mon, 16 Dec 2024 00:57:45 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:57:45 -0000",
  "auth_token": "oWKeE8wZxIslwt3hZG1hYpdLIS7AEbEg3V8NHuXvBrE",
  "friendly_name": "Rocket Rides",
  "owner_account_sid": "73764e5c-99dd-4ebd-ae8b-f8b8234fd11e",
  "status": "active",
  "type": "Full",
  "uri": "/2010-04-01/Accounts/73764e5c-99dd-4ebd-ae8b-f8b8234fd11e",
  "subresource_uris": {
    "calls": "/2010-04-01/Accounts/73764e5c-99dd-4ebd-ae8b-f8b8234fd11e/Calls",
    "messages": "/2010-04-01/Accounts/73764e5c-99dd-4ebd-ae8b-f8b8234fd11e/Messages",
    "recordings": "/2010-04-01/Accounts/73764e5c-99dd-4ebd-ae8b-f8b8234fd11e/Recordings"
  }
}

Available Phone Numbers

01. List the available Local phone numbers for a specific country

This API lets you search for Local phone numbers that are available for you to purchase.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/4abb9ea9-73f9-4f5a-a795-3cef6b88c2d3/AvailablePhoneNumbers/CA/Local" \
    -u 4abb9ea9-73f9-4f5a-a795-3cef6b88c2d3:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/AvailablePhoneNumbers/:CountryCode/:Type

GET https://api.somleng.org/2010-04-01/Accounts/4abb9ea9-73f9-4f5a-a795-3cef6b88c2d3/AvailablePhoneNumbers/CA/Local

Parameters

Name	Description
AccountSid	Path Parameter: The SID of the Account requesting the AvailablePhoneNumber resources.
CountryCode	Path Parameter: The ISO-3166-1 country code of the country from which to read phone numbers.
Type	Path Parameter: Type of phone numbers to read. One of `ShortCode`, `Local`, `Mobile`, `TollFree`.
AreaCode	Query Parameter: The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada.
InRegion	Query Parameter: Limit results to a particular region, state, or province.
InLocality	Query Parameter: Limit results to a particular locality or city.
InLata	Query Parameter: Limit results to a specific local access and transport area (LATA). Applies to only phone numbers in the US and Canada.
InRateCenter	Query Parameter: Limit results to a specific rate center. Requires `InLata` to be set as well. Applies to only phone numbers in the US and Canada.

Response


200 OK

{
  "available_phone_numbers": [
    {
      "friendly_name": "+1 (251) 309-5500",
      "phone_number": "+12513095500",
      "lata": null,
      "rate_center": null,
      "latitude": null,
      "longitude": null,
      "locality": null,
      "region": null,
      "postal_code": null,
      "iso_country": "CA",
      "address_requirements": "none",
      "beta": false,
      "capabilities": {
        "voice": true,
        "SMS": true,
        "MMS": false
      }
    }
  ],
  "uri": "/2010-04-01/Accounts/4abb9ea9-73f9-4f5a-a795-3cef6b88c2d3/AvailablePhoneNumbers/CA/Local",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/4abb9ea9-73f9-4f5a-a795-3cef6b88c2d3/AvailablePhoneNumbers/CA/Local?Page=0",
  "previous_page_uri": "/2010-04-01/Accounts/4abb9ea9-73f9-4f5a-a795-3cef6b88c2d3/AvailablePhoneNumbers/CA/Local?Page=0&PageToken=PBc75cc67c-5e39-4592-bc88-fcafc8e6b1de",
  "next_page_uri": null
}

02. Find available local phone numbers by area code

Find available Local phone numbers in Canada in the 201 area code.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/64006992-ae67-43c5-81bc-0124187046f3/AvailablePhoneNumbers/CA/Local?AreaCode=201" \
    -u 64006992-ae67-43c5-81bc-0124187046f3:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/AvailablePhoneNumbers/:CountryCode/:Type

GET https://api.somleng.org/2010-04-01/Accounts/64006992-ae67-43c5-81bc-0124187046f3/AvailablePhoneNumbers/CA/Local?AreaCode=201

Parameters

{
  "AreaCode": "201"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account requesting the AvailablePhoneNumber resources.
CountryCode	Path Parameter: The ISO-3166-1 country code of the country from which to read phone numbers.
Type	Path Parameter: Type of phone numbers to read. One of `ShortCode`, `Local`, `Mobile`, `TollFree`.
AreaCode	Query Parameter: The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada.
InRegion	Query Parameter: Limit results to a particular region, state, or province.
InLocality	Query Parameter: Limit results to a particular locality or city.
InLata	Query Parameter: Limit results to a specific local access and transport area (LATA). Applies to only phone numbers in the US and Canada.
InRateCenter	Query Parameter: Limit results to a specific rate center. Requires `InLata` to be set as well. Applies to only phone numbers in the US and Canada.

Response


200 OK

{
  "available_phone_numbers": [
    {
      "friendly_name": "+1 (201) 309-5500",
      "phone_number": "+12013095500",
      "lata": null,
      "rate_center": null,
      "latitude": null,
      "longitude": null,
      "locality": null,
      "region": null,
      "postal_code": null,
      "iso_country": "CA",
      "address_requirements": "none",
      "beta": false,
      "capabilities": {
        "voice": true,
        "SMS": true,
        "MMS": false
      }
    }
  ],
  "uri": "/2010-04-01/Accounts/64006992-ae67-43c5-81bc-0124187046f3/AvailablePhoneNumbers/CA/Local?AreaCode=201",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/64006992-ae67-43c5-81bc-0124187046f3/AvailablePhoneNumbers/CA/Local?AreaCode=201&Page=0",
  "previous_page_uri": "/2010-04-01/Accounts/64006992-ae67-43c5-81bc-0124187046f3/AvailablePhoneNumbers/CA/Local?AreaCode=201&Page=0&PageToken=PB6a2e0e27-998b-4770-86a6-5d8ee8d4c4db",
  "next_page_uri": null
}

03. Find available local phone numbers by region

Find available Local phone numbers in Ontario.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/361a6d5e-45f5-445a-816c-b5098bc75297/AvailablePhoneNumbers/CA/Local?InRegion=ON" \
    -u 361a6d5e-45f5-445a-816c-b5098bc75297:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/AvailablePhoneNumbers/:CountryCode/:Type

GET https://api.somleng.org/2010-04-01/Accounts/361a6d5e-45f5-445a-816c-b5098bc75297/AvailablePhoneNumbers/CA/Local?InRegion=ON

Parameters

{
  "InRegion": "ON"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account requesting the AvailablePhoneNumber resources.
CountryCode	Path Parameter: The ISO-3166-1 country code of the country from which to read phone numbers.
Type	Path Parameter: Type of phone numbers to read. One of `ShortCode`, `Local`, `Mobile`, `TollFree`.
AreaCode	Query Parameter: The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada.
InRegion	Query Parameter: Limit results to a particular region, state, or province.
InLocality	Query Parameter: Limit results to a particular locality or city.
InLata	Query Parameter: Limit results to a specific local access and transport area (LATA). Applies to only phone numbers in the US and Canada.
InRateCenter	Query Parameter: Limit results to a specific rate center. Requires `InLata` to be set as well. Applies to only phone numbers in the US and Canada.

Response


200 OK

{
  "available_phone_numbers": [
    {
      "friendly_name": "+1 (647) 309-5500",
      "phone_number": "+16473095500",
      "lata": null,
      "rate_center": null,
      "latitude": null,
      "longitude": null,
      "locality": null,
      "region": "ON",
      "postal_code": null,
      "iso_country": "CA",
      "address_requirements": "none",
      "beta": false,
      "capabilities": {
        "voice": true,
        "SMS": true,
        "MMS": false
      }
    }
  ],
  "uri": "/2010-04-01/Accounts/361a6d5e-45f5-445a-816c-b5098bc75297/AvailablePhoneNumbers/CA/Local?InRegion=ON",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/361a6d5e-45f5-445a-816c-b5098bc75297/AvailablePhoneNumbers/CA/Local?InRegion=ON&Page=0",
  "previous_page_uri": "/2010-04-01/Accounts/361a6d5e-45f5-445a-816c-b5098bc75297/AvailablePhoneNumbers/CA/Local?InRegion=ON&Page=0&PageToken=PB5f595e53-438a-48f6-9178-87ad6fe73efc",
  "next_page_uri": null
}

04. Find available local phone numbers by locality

Find available Local phone numbers in Toronto.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/3720794a-bdbf-4098-bbd5-f25d5f3991fb/AvailablePhoneNumbers/CA/Local?InLocality=Toronto" \
    -u 3720794a-bdbf-4098-bbd5-f25d5f3991fb:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/AvailablePhoneNumbers/:CountryCode/:Type

GET https://api.somleng.org/2010-04-01/Accounts/3720794a-bdbf-4098-bbd5-f25d5f3991fb/AvailablePhoneNumbers/CA/Local?InLocality=Toronto

Parameters

{
  "InLocality": "Toronto"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account requesting the AvailablePhoneNumber resources.
CountryCode	Path Parameter: The ISO-3166-1 country code of the country from which to read phone numbers.
Type	Path Parameter: Type of phone numbers to read. One of `ShortCode`, `Local`, `Mobile`, `TollFree`.
AreaCode	Query Parameter: The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada.
InRegion	Query Parameter: Limit results to a particular region, state, or province.
InLocality	Query Parameter: Limit results to a particular locality or city.
InLata	Query Parameter: Limit results to a specific local access and transport area (LATA). Applies to only phone numbers in the US and Canada.
InRateCenter	Query Parameter: Limit results to a specific rate center. Requires `InLata` to be set as well. Applies to only phone numbers in the US and Canada.

Response


200 OK

{
  "available_phone_numbers": [
    {
      "friendly_name": "+1 (647) 309-5500",
      "phone_number": "+16473095500",
      "lata": null,
      "rate_center": null,
      "latitude": null,
      "longitude": null,
      "locality": "Toronto",
      "region": "ON",
      "postal_code": null,
      "iso_country": "CA",
      "address_requirements": "none",
      "beta": false,
      "capabilities": {
        "voice": true,
        "SMS": true,
        "MMS": false
      }
    }
  ],
  "uri": "/2010-04-01/Accounts/3720794a-bdbf-4098-bbd5-f25d5f3991fb/AvailablePhoneNumbers/CA/Local?InLocality=Toronto",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/3720794a-bdbf-4098-bbd5-f25d5f3991fb/AvailablePhoneNumbers/CA/Local?InLocality=Toronto&Page=0",
  "previous_page_uri": "/2010-04-01/Accounts/3720794a-bdbf-4098-bbd5-f25d5f3991fb/AvailablePhoneNumbers/CA/Local?InLocality=Toronto&Page=0&PageToken=PB8d6769aa-5f61-4457-a6ca-a70cd37c551f",
  "next_page_uri": null
}

05. Find available local phone numbers by LATA and Rate center

Find available Local phone numbers in LATA 888 and Rate Center NEWTORONTO.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/fe7153bf-8d7d-42d0-a62d-d79d034f8b7e/AvailablePhoneNumbers/CA/Local?InLata=888&InRateCenter=NEWTORONTO" \
    -u fe7153bf-8d7d-42d0-a62d-d79d034f8b7e:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/AvailablePhoneNumbers/:CountryCode/:Type

GET https://api.somleng.org/2010-04-01/Accounts/fe7153bf-8d7d-42d0-a62d-d79d034f8b7e/AvailablePhoneNumbers/CA/Local?InLata=888&amp;InRateCenter=NEWTORONTO

Parameters

{
  "InLata": "888",
  "InRateCenter": "NEWTORONTO"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account requesting the AvailablePhoneNumber resources.
CountryCode	Path Parameter: The ISO-3166-1 country code of the country from which to read phone numbers.
Type	Path Parameter: Type of phone numbers to read. One of `ShortCode`, `Local`, `Mobile`, `TollFree`.
AreaCode	Query Parameter: The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada.
InRegion	Query Parameter: Limit results to a particular region, state, or province.
InLocality	Query Parameter: Limit results to a particular locality or city.
InLata	Query Parameter: Limit results to a specific local access and transport area (LATA). Applies to only phone numbers in the US and Canada.
InRateCenter	Query Parameter: Limit results to a specific rate center. Requires `InLata` to be set as well. Applies to only phone numbers in the US and Canada.

Response


200 OK

{
  "available_phone_numbers": [
    {
      "friendly_name": "+1 (647) 309-5500",
      "phone_number": "+16473095500",
      "lata": "888",
      "rate_center": "NEWTORONTO",
      "latitude": null,
      "longitude": null,
      "locality": "Toronto",
      "region": "ON",
      "postal_code": null,
      "iso_country": "CA",
      "address_requirements": "none",
      "beta": false,
      "capabilities": {
        "voice": true,
        "SMS": true,
        "MMS": false
      }
    }
  ],
  "uri": "/2010-04-01/Accounts/fe7153bf-8d7d-42d0-a62d-d79d034f8b7e/AvailablePhoneNumbers/CA/Local?InLata=888&InRateCenter=NEWTORONTO",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/fe7153bf-8d7d-42d0-a62d-d79d034f8b7e/AvailablePhoneNumbers/CA/Local?InLata=888&InRateCenter=NEWTORONTO&Page=0",
  "previous_page_uri": "/2010-04-01/Accounts/fe7153bf-8d7d-42d0-a62d-d79d034f8b7e/AvailablePhoneNumbers/CA/Local?InLata=888&InRateCenter=NEWTORONTO&Page=0&PageToken=PBbea0bb2c-a234-4ccd-912b-d5c851d46602",
  "next_page_uri": null
}

06. List the available Mobile phone numbers for a specific country

This API lets you search for Mobile phone numbers that are available for you to purchase.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/29e516c2-9405-4b2e-a889-79673021d5a9/AvailablePhoneNumbers/CA/Mobile" \
    -u 29e516c2-9405-4b2e-a889-79673021d5a9:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/AvailablePhoneNumbers/:CountryCode/:Type

GET https://api.somleng.org/2010-04-01/Accounts/29e516c2-9405-4b2e-a889-79673021d5a9/AvailablePhoneNumbers/CA/Mobile

Parameters

Name	Description
AccountSid	Path Parameter: The SID of the Account requesting the AvailablePhoneNumber resources.
CountryCode	Path Parameter: The ISO-3166-1 country code of the country from which to read phone numbers.
Type	Path Parameter: Type of phone numbers to read. One of `ShortCode`, `Local`, `Mobile`, `TollFree`.
AreaCode	Query Parameter: The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada.
InRegion	Query Parameter: Limit results to a particular region, state, or province.
InLocality	Query Parameter: Limit results to a particular locality or city.
InLata	Query Parameter: Limit results to a specific local access and transport area (LATA). Applies to only phone numbers in the US and Canada.
InRateCenter	Query Parameter: Limit results to a specific rate center. Requires `InLata` to be set as well. Applies to only phone numbers in the US and Canada.

Response


200 OK

{
  "available_phone_numbers": [
    {
      "friendly_name": "+1 (251) 309-5500",
      "phone_number": "+12513095500",
      "lata": null,
      "rate_center": null,
      "latitude": null,
      "longitude": null,
      "locality": null,
      "region": null,
      "postal_code": null,
      "iso_country": "CA",
      "address_requirements": "none",
      "beta": false,
      "capabilities": {
        "voice": true,
        "SMS": true,
        "MMS": false
      }
    }
  ],
  "uri": "/2010-04-01/Accounts/29e516c2-9405-4b2e-a889-79673021d5a9/AvailablePhoneNumbers/CA/Mobile",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/29e516c2-9405-4b2e-a889-79673021d5a9/AvailablePhoneNumbers/CA/Mobile?Page=0",
  "previous_page_uri": "/2010-04-01/Accounts/29e516c2-9405-4b2e-a889-79673021d5a9/AvailablePhoneNumbers/CA/Mobile?Page=0&PageToken=PB582b60ea-2702-43d5-9ffd-2612f921c3c8",
  "next_page_uri": null
}

07. List the available Toll Free phone numbers for a specific country

This API lets you search for TollFree phone numbers that are available for you to purchase.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/91c70234-f0b6-4afe-94bb-0d6304c1f80b/AvailablePhoneNumbers/CA/TollFree" \
    -u 91c70234-f0b6-4afe-94bb-0d6304c1f80b:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/AvailablePhoneNumbers/:CountryCode/:Type

GET https://api.somleng.org/2010-04-01/Accounts/91c70234-f0b6-4afe-94bb-0d6304c1f80b/AvailablePhoneNumbers/CA/TollFree

Parameters

Name	Description
AccountSid	Path Parameter: The SID of the Account requesting the AvailablePhoneNumber resources.
CountryCode	Path Parameter: The ISO-3166-1 country code of the country from which to read phone numbers.
Type	Path Parameter: Type of phone numbers to read. One of `ShortCode`, `Local`, `Mobile`, `TollFree`.
AreaCode	Query Parameter: The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada.
InRegion	Query Parameter: Limit results to a particular region, state, or province.
InLocality	Query Parameter: Limit results to a particular locality or city.
InLata	Query Parameter: Limit results to a specific local access and transport area (LATA). Applies to only phone numbers in the US and Canada.
InRateCenter	Query Parameter: Limit results to a specific rate center. Requires `InLata` to be set as well. Applies to only phone numbers in the US and Canada.

Response


200 OK

{
  "available_phone_numbers": [
    {
      "friendly_name": "+1 (877) 731-8091",
      "phone_number": "+18777318091",
      "lata": null,
      "rate_center": null,
      "latitude": null,
      "longitude": null,
      "locality": null,
      "region": null,
      "postal_code": null,
      "iso_country": "CA",
      "address_requirements": "none",
      "beta": false,
      "capabilities": {
        "voice": true,
        "SMS": true,
        "MMS": false
      }
    }
  ],
  "uri": "/2010-04-01/Accounts/91c70234-f0b6-4afe-94bb-0d6304c1f80b/AvailablePhoneNumbers/CA/TollFree",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/91c70234-f0b6-4afe-94bb-0d6304c1f80b/AvailablePhoneNumbers/CA/TollFree?Page=0",
  "previous_page_uri": "/2010-04-01/Accounts/91c70234-f0b6-4afe-94bb-0d6304c1f80b/AvailablePhoneNumbers/CA/TollFree?Page=0&PageToken=PBd665a813-c320-4c7f-8937-3b598da8aba3",
  "next_page_uri": null
}

08. List the available Short Code numbers for a specific country

This API lets you search for Short Code phone numbers that are available for you to purchase.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/32dd3702-a374-4522-a83f-a52b2a3511f1/AvailablePhoneNumbers/CA/ShortCode" \
    -u 32dd3702-a374-4522-a83f-a52b2a3511f1:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/AvailablePhoneNumbers/:CountryCode/:Type

GET https://api.somleng.org/2010-04-01/Accounts/32dd3702-a374-4522-a83f-a52b2a3511f1/AvailablePhoneNumbers/CA/ShortCode

Parameters

Name	Description
AccountSid	Path Parameter: The SID of the Account requesting the AvailablePhoneNumber resources.
CountryCode	Path Parameter: The ISO-3166-1 country code of the country from which to read phone numbers.
Type	Path Parameter: Type of phone numbers to read. One of `ShortCode`, `Local`, `Mobile`, `TollFree`.
AreaCode	Query Parameter: The area code of the phone numbers to read. Applies to only phone numbers in the US and Canada.
InRegion	Query Parameter: Limit results to a particular region, state, or province.
InLocality	Query Parameter: Limit results to a particular locality or city.
InLata	Query Parameter: Limit results to a specific local access and transport area (LATA). Applies to only phone numbers in the US and Canada.
InRateCenter	Query Parameter: Limit results to a specific rate center. Requires `InLata` to be set as well. Applies to only phone numbers in the US and Canada.

Response


200 OK

{
  "available_phone_numbers": [
    {
      "friendly_name": "1294",
      "phone_number": "1294",
      "lata": null,
      "rate_center": null,
      "latitude": null,
      "longitude": null,
      "locality": null,
      "region": null,
      "postal_code": null,
      "iso_country": "CA",
      "address_requirements": "none",
      "beta": false,
      "capabilities": {
        "voice": true,
        "SMS": true,
        "MMS": false
      }
    }
  ],
  "uri": "/2010-04-01/Accounts/32dd3702-a374-4522-a83f-a52b2a3511f1/AvailablePhoneNumbers/CA/ShortCode",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/32dd3702-a374-4522-a83f-a52b2a3511f1/AvailablePhoneNumbers/CA/ShortCode?Page=0",
  "previous_page_uri": "/2010-04-01/Accounts/32dd3702-a374-4522-a83f-a52b2a3511f1/AvailablePhoneNumbers/CA/ShortCode?Page=0&PageToken=PB00cd64c9-fb5d-4b81-9118-e2075c71f538",
  "next_page_uri": null
}

09. Read a list of countries

You can query the AvailablePhoneNumbers to get a list of subresources available for your account by ISO Country. This API gets the subresources available for all supported countries.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers" \
    -u 36c26753-a521-4dc0-b12a-cab623468b7a:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/AvailablePhoneNumbers

GET https://api.somleng.org/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers

Parameters

Name	Description
AccountSid	Path Parameter: The SID of the Account requesting the available phone number Country resources.

Response


200 OK

{
  "countries": [
    {
      "country_code": "CA",
      "country": "Canada",
      "uri": "/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers/CA",
      "beta": false,
      "subresource_uris": {
        "short_code": "/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers/CA/ShortCode",
        "local": "/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers/CA/Local",
        "mobile": "/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers/CA/Mobile",
        "toll_free": "/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers/CA/TollFree"
      }
    },
    {
      "country_code": "KH",
      "country": "Cambodia",
      "uri": "/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers/KH",
      "beta": false,
      "subresource_uris": {
        "short_code": "/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers/KH/ShortCode",
        "local": "/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers/KH/Local",
        "mobile": "/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers/KH/Mobile",
        "toll_free": "/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers/KH/TollFree"
      }
    }
  ],
  "uri": "/2010-04-01/Accounts/36c26753-a521-4dc0-b12a-cab623468b7a/AvailablePhoneNumbers"
}

10. Fetch a specific country

Fetch the subresources available for a specific country. The subresources will contain a list of endpoints which can be used to fetch available phone numbers for that country.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/8666ed26-b60d-47ef-a8a1-b466103504c7/AvailablePhoneNumbers/CA" \
    -u 8666ed26-b60d-47ef-a8a1-b466103504c7:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/AvailablePhoneNumbers/:CountryCode

GET https://api.somleng.org/2010-04-01/Accounts/8666ed26-b60d-47ef-a8a1-b466103504c7/AvailablePhoneNumbers/CA

Parameters

Name	Description
AccountSid	Path Parameter: The SID of the Account requesting the available phone number Country resource.
CountryCode	Path Parameter: The ISO-3166-1 country code of the country to fetch available phone number information about.

Response


200 OK

{
  "country_code": "CA",
  "country": "Canada",
  "uri": "/2010-04-01/Accounts/8666ed26-b60d-47ef-a8a1-b466103504c7/AvailablePhoneNumbers/CA",
  "beta": false,
  "subresource_uris": {
    "short_code": "/2010-04-01/Accounts/8666ed26-b60d-47ef-a8a1-b466103504c7/AvailablePhoneNumbers/CA/ShortCode",
    "local": "/2010-04-01/Accounts/8666ed26-b60d-47ef-a8a1-b466103504c7/AvailablePhoneNumbers/CA/Local",
    "mobile": "/2010-04-01/Accounts/8666ed26-b60d-47ef-a8a1-b466103504c7/AvailablePhoneNumbers/CA/Mobile",
    "toll_free": "/2010-04-01/Accounts/8666ed26-b60d-47ef-a8a1-b466103504c7/AvailablePhoneNumbers/CA/TollFree"
  }
}

Incoming Phone Numbers

An IncomingPhoneNumber resource represents a phone number provisioned to your account. The IncomingPhoneNumbers list resource represents an account's phone numbers. You can POST to the list resource to provision a new number. To find a new number to provision use the subresources of the [Available Phone Numbers] resource.

01. Provision a Phone Number

You can POST to this API to provision a new phone number. To find a new number to provision use the Available Phone Numbers API.

You will be charged when you provision the number, and the number will appear on the Active Numbers page in the console.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/5b4f00bc-820c-4421-85ee-7a0e8f1f0024/IncomingPhoneNumbers" \
    -u 5b4f00bc-820c-4421-85ee-7a0e8f1f0024:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "PhoneNumber=+12513095500"

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/IncomingPhoneNumbers

POST https://api.somleng.org/2010-04-01/Accounts/5b4f00bc-820c-4421-85ee-7a0e8f1f0024/IncomingPhoneNumbers

Parameters

{
  "PhoneNumber": "+12513095500"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account that will create the resource.
PhoneNumber required	Request Body Parameter: The phone number to purchase specified in E.164 format.
FriendlyName	Request Body Parameter: A descriptive string that you created to describe the new phone number. It can be up to 64 characters long. By default, this is a formatted version of the new phone number.
SmsUrl	Request Body Parameter: The URL we should call when the new phone number receives an incoming SMS message.
SmsMethod	Request Body Parameter: The HTTP method that we should use to call `sms_url`. Can be: `GET` or `POST` and defaults to `POST`.
VoiceUrl	Request Body Parameter: The URL that we should call to answer a call to the new phone number.
VoiceMethod	Request Body Parameter: The HTTP method that we should use to call `voice_url`. Can be: `GET` or `POST` and defaults to `POST`.
StatusCallback	Request Body Parameter: The URL we should call using the `status_callback_method` to send status information to your application.
StatusCallbackMethod	Request Body Parameter: The HTTP method we should use to call `status_callback`. Can be: `GET` or `POST` and defaults to `POST`.

Response


201 Created

{
  "api_version": "2010-04-01",
  "sid": "4eb4ca8b-35fb-43f4-8569-410fa179b0ed",
  "date_created": "Mon, 16 Dec 2024 00:58:25 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:58:25 -0000",
  "account_sid": "5b4f00bc-820c-4421-85ee-7a0e8f1f0024",
  "address_requirements": "none",
  "address_sid": null,
  "beta": false,
  "capabilities": {
    "voice": true,
    "sms": true,
    "mms": false,
    "fax": false
  },
  "emergency_status": "Inactive",
  "emergency_address_sid": null,
  "emergency_address_status": "unregistered",
  "friendly_name": "+1 (251) 309-5500",
  "identity_sid": null,
  "origin": "hosted",
  "phone_number": "+12513095500",
  "sms_application_sid": null,
  "sms_fallback_method": "POST",
  "sms_fallback_url": null,
  "sms_method": "POST",
  "sms_url": null,
  "status_callback": null,
  "status_callback_method": "POST",
  "trunk_sid": null,
  "uri": "/2010-04-01/Accounts/5b4f00bc-820c-4421-85ee-7a0e8f1f0024/IncomingPhoneNumbers/4eb4ca8b-35fb-43f4-8569-410fa179b0ed",
  "voice_application_sid": null,
  "voice_caller_id_lookup": false,
  "voice_fallback_method": "POST",
  "voice_fallback_url": null,
  "voice_method": "POST",
  "voice_url": null,
  "bundle_sid": null,
  "voice_receive_mode": "voice",
  "status": "in-use"
}

02. Provision a Phone Number with a Voice URL

You will receive a HTTP request to this URL when a call comes in to your phone number.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/09ff4fde-62b0-4324-8363-6d6567562158/IncomingPhoneNumbers" \
    -u 09ff4fde-62b0-4324-8363-6d6567562158:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "PhoneNumber=+12513095500" \
    --data-urlencode "VoiceUrl=https://www.your-voice-url.com/example"

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/IncomingPhoneNumbers

POST https://api.somleng.org/2010-04-01/Accounts/09ff4fde-62b0-4324-8363-6d6567562158/IncomingPhoneNumbers

Parameters

{
  "PhoneNumber": "+12513095500",
  "VoiceUrl": "https://www.your-voice-url.com/example"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account that will create the resource.
PhoneNumber required	Request Body Parameter: The phone number to purchase specified in E.164 format.
FriendlyName	Request Body Parameter: A descriptive string that you created to describe the new phone number. It can be up to 64 characters long. By default, this is a formatted version of the new phone number.
SmsUrl	Request Body Parameter: The URL we should call when the new phone number receives an incoming SMS message.
SmsMethod	Request Body Parameter: The HTTP method that we should use to call `sms_url`. Can be: `GET` or `POST` and defaults to `POST`.
VoiceUrl	Request Body Parameter: The URL that we should call to answer a call to the new phone number.
VoiceMethod	Request Body Parameter: The HTTP method that we should use to call `voice_url`. Can be: `GET` or `POST` and defaults to `POST`.
StatusCallback	Request Body Parameter: The URL we should call using the `status_callback_method` to send status information to your application.
StatusCallbackMethod	Request Body Parameter: The HTTP method we should use to call `status_callback`. Can be: `GET` or `POST` and defaults to `POST`.

Response


201 Created

{
  "api_version": "2010-04-01",
  "sid": "bd0b812e-590e-4803-abf2-cd280353eac4",
  "date_created": "Mon, 16 Dec 2024 00:58:25 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:58:25 -0000",
  "account_sid": "09ff4fde-62b0-4324-8363-6d6567562158",
  "address_requirements": "none",
  "address_sid": null,
  "beta": false,
  "capabilities": {
    "voice": true,
    "sms": true,
    "mms": false,
    "fax": false
  },
  "emergency_status": "Inactive",
  "emergency_address_sid": null,
  "emergency_address_status": "unregistered",
  "friendly_name": "+1 (251) 309-5500",
  "identity_sid": null,
  "origin": "hosted",
  "phone_number": "+12513095500",
  "sms_application_sid": null,
  "sms_fallback_method": "POST",
  "sms_fallback_url": null,
  "sms_method": "POST",
  "sms_url": null,
  "status_callback": null,
  "status_callback_method": "POST",
  "trunk_sid": null,
  "uri": "/2010-04-01/Accounts/09ff4fde-62b0-4324-8363-6d6567562158/IncomingPhoneNumbers/bd0b812e-590e-4803-abf2-cd280353eac4",
  "voice_application_sid": null,
  "voice_caller_id_lookup": false,
  "voice_fallback_method": "POST",
  "voice_fallback_url": null,
  "voice_method": "POST",
  "voice_url": "https://www.your-voice-url.com/example",
  "bundle_sid": null,
  "voice_receive_mode": "voice",
  "status": "in-use"
}

03. Provision a Phone Number with an SMS URL

You will receive a HTTP request to this URL when an SMS is sent to your phone number.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/5b7549f5-83ef-4fc1-8af5-7448fdae08ac/IncomingPhoneNumbers" \
    -u 5b7549f5-83ef-4fc1-8af5-7448fdae08ac:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "PhoneNumber=+12513095500" \
    --data-urlencode "SmsUrl=https://www.your-sms-url.com/example"

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/IncomingPhoneNumbers

POST https://api.somleng.org/2010-04-01/Accounts/5b7549f5-83ef-4fc1-8af5-7448fdae08ac/IncomingPhoneNumbers

Parameters

{
  "PhoneNumber": "+12513095500",
  "SmsUrl": "https://www.your-sms-url.com/example"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account that will create the resource.
PhoneNumber required	Request Body Parameter: The phone number to purchase specified in E.164 format.
FriendlyName	Request Body Parameter: A descriptive string that you created to describe the new phone number. It can be up to 64 characters long. By default, this is a formatted version of the new phone number.
SmsUrl	Request Body Parameter: The URL we should call when the new phone number receives an incoming SMS message.
SmsMethod	Request Body Parameter: The HTTP method that we should use to call `sms_url`. Can be: `GET` or `POST` and defaults to `POST`.
VoiceUrl	Request Body Parameter: The URL that we should call to answer a call to the new phone number.
VoiceMethod	Request Body Parameter: The HTTP method that we should use to call `voice_url`. Can be: `GET` or `POST` and defaults to `POST`.
StatusCallback	Request Body Parameter: The URL we should call using the `status_callback_method` to send status information to your application.
StatusCallbackMethod	Request Body Parameter: The HTTP method we should use to call `status_callback`. Can be: `GET` or `POST` and defaults to `POST`.

Response


201 Created

{
  "api_version": "2010-04-01",
  "sid": "a75e2ea5-68ab-4930-a44b-ae3c2f641469",
  "date_created": "Mon, 16 Dec 2024 00:58:25 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:58:25 -0000",
  "account_sid": "5b7549f5-83ef-4fc1-8af5-7448fdae08ac",
  "address_requirements": "none",
  "address_sid": null,
  "beta": false,
  "capabilities": {
    "voice": true,
    "sms": true,
    "mms": false,
    "fax": false
  },
  "emergency_status": "Inactive",
  "emergency_address_sid": null,
  "emergency_address_status": "unregistered",
  "friendly_name": "+1 (251) 309-5500",
  "identity_sid": null,
  "origin": "hosted",
  "phone_number": "+12513095500",
  "sms_application_sid": null,
  "sms_fallback_method": "POST",
  "sms_fallback_url": null,
  "sms_method": "POST",
  "sms_url": "https://www.your-sms-url.com/example",
  "status_callback": null,
  "status_callback_method": "POST",
  "trunk_sid": null,
  "uri": "/2010-04-01/Accounts/5b7549f5-83ef-4fc1-8af5-7448fdae08ac/IncomingPhoneNumbers/a75e2ea5-68ab-4930-a44b-ae3c2f641469",
  "voice_application_sid": null,
  "voice_caller_id_lookup": false,
  "voice_fallback_method": "POST",
  "voice_fallback_url": null,
  "voice_method": "POST",
  "voice_url": null,
  "bundle_sid": null,
  "voice_receive_mode": "voice",
  "status": "in-use"
}

04. Fetch an IncomingPhoneNumber resource

Fetch an IncomingPhoneNumber

Request

curl "https://api.somleng.org/2010-04-01/Accounts/d711f212-8951-4ccd-bb0d-100c12c57886/IncomingPhoneNumbers/a08b3c1e-08c9-438b-8c33-d5337fd4bdc4" \
    -u d711f212-8951-4ccd-bb0d-100c12c57886:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/IncomingPhoneNumbers/:Sid

GET https://api.somleng.org/2010-04-01/Accounts/d711f212-8951-4ccd-bb0d-100c12c57886/IncomingPhoneNumbers/a08b3c1e-08c9-438b-8c33-d5337fd4bdc4

Parameters

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the IncomingPhoneNumber resource to fetch.
Sid	Path Parameter: The SID of the IncomingPhoneNumber resource to be fetched.

Response


200 OK

{
  "api_version": "2010-04-01",
  "sid": "a08b3c1e-08c9-438b-8c33-d5337fd4bdc4",
  "date_created": "Mon, 16 Dec 2024 00:58:25 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:58:25 -0000",
  "account_sid": "d711f212-8951-4ccd-bb0d-100c12c57886",
  "address_requirements": "none",
  "address_sid": null,
  "beta": false,
  "capabilities": {
    "voice": true,
    "sms": true,
    "mms": false,
    "fax": false
  },
  "emergency_status": "Inactive",
  "emergency_address_sid": null,
  "emergency_address_status": "unregistered",
  "friendly_name": "+1 (251) 309-5500",
  "identity_sid": null,
  "origin": "hosted",
  "phone_number": "+12513095500",
  "sms_application_sid": null,
  "sms_fallback_method": "POST",
  "sms_fallback_url": null,
  "sms_method": "POST",
  "sms_url": null,
  "status_callback": null,
  "status_callback_method": "POST",
  "trunk_sid": null,
  "uri": "/2010-04-01/Accounts/d711f212-8951-4ccd-bb0d-100c12c57886/IncomingPhoneNumbers/a08b3c1e-08c9-438b-8c33-d5337fd4bdc4",
  "voice_application_sid": null,
  "voice_caller_id_lookup": false,
  "voice_fallback_method": "POST",
  "voice_fallback_url": null,
  "voice_method": "POST",
  "voice_url": null,
  "bundle_sid": null,
  "voice_receive_mode": "voice",
  "status": "in-use"
}

05. Read a list of Incoming Phone Numbers

List all IncomingPhoneNumber resources for your account.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/55f6ce08-ab20-4e13-b1fc-f58c6fc46eb6/IncomingPhoneNumbers?PhoneNumber=%2B12513095500" \
    -u 55f6ce08-ab20-4e13-b1fc-f58c6fc46eb6:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/IncomingPhoneNumbers

GET https://api.somleng.org/2010-04-01/Accounts/55f6ce08-ab20-4e13-b1fc-f58c6fc46eb6/IncomingPhoneNumbers?PhoneNumber=%2B12513095500

Parameters

{
  "PhoneNumber": "+12513095500"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the IncomingPhoneNumber resource to read.
PhoneNumber	Query Parameter: The phone number of the IncomingPhoneNumber resources to read.

Response


200 OK

{
  "incoming_phone_numbers": [
    {
      "api_version": "2010-04-01",
      "sid": "6aa8cc8b-01f9-4284-9635-e5749c4c4f34",
      "date_created": "Mon, 16 Dec 2024 00:58:25 -0000",
      "date_updated": "Mon, 16 Dec 2024 00:58:25 -0000",
      "account_sid": "55f6ce08-ab20-4e13-b1fc-f58c6fc46eb6",
      "address_requirements": "none",
      "address_sid": null,
      "beta": false,
      "capabilities": {
        "voice": true,
        "sms": true,
        "mms": false,
        "fax": false
      },
      "emergency_status": "Inactive",
      "emergency_address_sid": null,
      "emergency_address_status": "unregistered",
      "friendly_name": "+1 (251) 309-5500",
      "identity_sid": null,
      "origin": "hosted",
      "phone_number": "+12513095500",
      "sms_application_sid": null,
      "sms_fallback_method": "POST",
      "sms_fallback_url": null,
      "sms_method": "POST",
      "sms_url": null,
      "status_callback": null,
      "status_callback_method": "POST",
      "trunk_sid": null,
      "uri": "/2010-04-01/Accounts/55f6ce08-ab20-4e13-b1fc-f58c6fc46eb6/IncomingPhoneNumbers/6aa8cc8b-01f9-4284-9635-e5749c4c4f34",
      "voice_application_sid": null,
      "voice_caller_id_lookup": false,
      "voice_fallback_method": "POST",
      "voice_fallback_url": null,
      "voice_method": "POST",
      "voice_url": null,
      "bundle_sid": null,
      "voice_receive_mode": "voice",
      "status": "in-use"
    }
  ],
  "uri": "/2010-04-01/Accounts/55f6ce08-ab20-4e13-b1fc-f58c6fc46eb6/IncomingPhoneNumbers?PhoneNumber=%2B12513095500",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/55f6ce08-ab20-4e13-b1fc-f58c6fc46eb6/IncomingPhoneNumbers?Page=0&PhoneNumber=%2B12513095500",
  "previous_page_uri": "/2010-04-01/Accounts/55f6ce08-ab20-4e13-b1fc-f58c6fc46eb6/IncomingPhoneNumbers?Page=0&PageToken=PB6aa8cc8b-01f9-4284-9635-e5749c4c4f34&PhoneNumber=%2B12513095500",
  "next_page_uri": null
}

06. Update IncomingPhoneNumber to use a new Voice URL

You will receive a HTTP request to this URL when a call comes in to your phone number.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/acc15617-6df8-4163-af64-0d361f26a9c9/IncomingPhoneNumbers/363b658e-794b-40f9-8a28-38336908f8d0" \
    -u acc15617-6df8-4163-af64-0d361f26a9c9:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "VoiceUrl=https://www.your-voice-url.com/example"

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/IncomingPhoneNumbers/:Sid

POST https://api.somleng.org/2010-04-01/Accounts/acc15617-6df8-4163-af64-0d361f26a9c9/IncomingPhoneNumbers/363b658e-794b-40f9-8a28-38336908f8d0

Parameters

{
  "VoiceUrl": "https://www.your-voice-url.com/example"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the IncomingPhoneNumber resource to update.
Sid	Path Parameter: The SID of the IncomingPhoneNumber resource to update.
FriendlyName	Request Body Parameter: A descriptive string that you created to describe the new phone number. It can be up to 64 characters long. By default, this is a formatted version of the new phone number.
SmsUrl	Request Body Parameter: The URL we should call when the new phone number receives an incoming SMS message.
SmsMethod	Request Body Parameter: The HTTP method that we should use to call `sms_url`. Can be: `GET` or `POST` and defaults to `POST`.
VoiceUrl	Request Body Parameter: The URL that we should call to answer a call to the new phone number.
VoiceMethod	Request Body Parameter: The HTTP method that we should use to call `voice_url`. Can be: `GET` or `POST` and defaults to `POST`.
StatusCallback	Request Body Parameter: The URL we should call using the `status_callback_method` to send status information to your application.
StatusCallbackMethod	Request Body Parameter: The HTTP method we should use to call `status_callback`. Can be: `GET` or `POST` and defaults to `POST`.

Response


200 OK

{
  "api_version": "2010-04-01",
  "sid": "363b658e-794b-40f9-8a28-38336908f8d0",
  "date_created": "Mon, 16 Dec 2024 00:58:25 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:58:25 -0000",
  "account_sid": "acc15617-6df8-4163-af64-0d361f26a9c9",
  "address_requirements": "none",
  "address_sid": null,
  "beta": false,
  "capabilities": {
    "voice": true,
    "sms": true,
    "mms": false,
    "fax": false
  },
  "emergency_status": "Inactive",
  "emergency_address_sid": null,
  "emergency_address_status": "unregistered",
  "friendly_name": "+855 97 234 5831",
  "identity_sid": null,
  "origin": "hosted",
  "phone_number": "+855972345831",
  "sms_application_sid": null,
  "sms_fallback_method": "POST",
  "sms_fallback_url": null,
  "sms_method": "POST",
  "sms_url": null,
  "status_callback": null,
  "status_callback_method": "POST",
  "trunk_sid": null,
  "uri": "/2010-04-01/Accounts/acc15617-6df8-4163-af64-0d361f26a9c9/IncomingPhoneNumbers/363b658e-794b-40f9-8a28-38336908f8d0",
  "voice_application_sid": null,
  "voice_caller_id_lookup": false,
  "voice_fallback_method": "POST",
  "voice_fallback_url": null,
  "voice_method": "POST",
  "voice_url": "https://www.your-voice-url.com/example",
  "bundle_sid": null,
  "voice_receive_mode": "voice",
  "status": "in-use"
}

07. Delete an IncomingPhoneNumber

Release this phone number from your account. We will no longer answer calls to this number, and you will stop being billed the monthly phone number fee. The phone number will be recycled and potentially given to another customer, so use with care.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/c489d7b1-8eb7-4b80-bac1-f3a5a77f4ee7/IncomingPhoneNumbers/f73f468d-c3be-4bbe-b14b-7d29028e9169" -d '' -X DELETE \
    -u c489d7b1-8eb7-4b80-bac1-f3a5a77f4ee7:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded"

Endpoint

DELETE https://api.somleng.org/2010-04-01/Accounts/:AccountSid/IncomingPhoneNumbers/:Sid

DELETE https://api.somleng.org/2010-04-01/Accounts/c489d7b1-8eb7-4b80-bac1-f3a5a77f4ee7/IncomingPhoneNumbers/f73f468d-c3be-4bbe-b14b-7d29028e9169

Parameters

{}

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the IncomingPhoneNumber resource to delete.
Sid	Path Parameter: The SID of the IncomingPhoneNumber resource to delete.

Response


204 No Content

Messages

01. Send an SMS Message

The example below shows how to create a Message resource with an SMS recipient. Sending this POST request creates text message from +855716788999 (a phone number belonging to the Account sending the request) to +855716788123. The content of the text message is Hello World.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/9fa4887d-02fd-40b5-a1d4-857d7e963b5a/Messages" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u 9fa4887d-02fd-40b5-a1d4-857d7e963b5a:AuthToken \
    --data-urlencode "To=+855716788123" \
    --data-urlencode "From=+855716788999" \
    --data-urlencode "Body=Hello World"

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Messages

POST https://api.somleng.org/2010-04-01/Accounts/9fa4887d-02fd-40b5-a1d4-857d7e963b5a/Messages

Parameters

{
  "To": "+855716788123",
  "From": "+855716788999",
  "Body": "Hello World"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account creating the Message resource.
From	Request Body Parameter: A phone number in E.164 format. Required if MessagingServiceSid is not passed
MessagingServiceSid	Request Body Parameter: The SID of the Messaging Service you want to associate with the Message. Set this parameter to use the Messaging Service Settings you have configured and leave the `From` parameter empty. When only this parameter is set, we will select the `From` phone number for delivery.
Body required	Request Body Parameter: The text of the message you want to send. Can be up to 1,600 characters in length.
To required	Request Body Parameter: The destination phone number in E.164 format
StatusCallback	Request Body Parameter: The URL we should call to send status information to your application. If specified, we POST these message status changes to the URL: `queued`, `failed`, `sent`, `delivered`, or `undelivered`. Somleng will POST its standard request parameters as well as some additional parameters including `MessageSid`, `MessageStatus`, and `ErrorCode`. URLs must contain a valid hostname (underscores are not permitted).
StatusCallbackMethod	Request Body Parameter: The HTTP method we should use when calling the `status_callback` URL. Can be: `GET` or `POST` and the default is `POST`.
ValidityPeriod	Request Body Parameter: How long in seconds the message can remain in our outgoing message queue. After this period elapses, the message fails and we call your status callback. Can be between 1 and the default value of 14,400 seconds. After a message has been accepted by a carrier, however, we cannot guarantee that the message will not be queued after this period. We recommend that this value be at least 5 seconds.
SmartEncoded	Request Body Parameter: Whether to detect Unicode characters that have a similar GSM-7 character and replace them. Can be: `true` or `false`.
ScheduleType	Request Body Parameter: Indicates your intent to schedule a message. Pass the value `fixed` to schedule a message at a fixed time.
SendAt	Request Body Parameter: The time that we will send the message. Must be in ISO 8601 format.

Response


201 Created

{
  "api_version": "2010-04-01",
  "sid": "bad38e8a-1084-4bc6-9976-801ce4d701e1",
  "date_created": "Mon, 16 Dec 2024 00:58:24 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:58:24 -0000",
  "account_sid": "9fa4887d-02fd-40b5-a1d4-857d7e963b5a",
  "body": "Hello World",
  "date_sent": null,
  "direction": "outbound-api",
  "error_code": null,
  "error_message": null,
  "from": "+855716788999",
  "messaging_service_sid": null,
  "num_media": "0",
  "num_segments": "1",
  "price": null,
  "price_unit": null,
  "status": "queued",
  "subresource_uris": {},
  "tags": {},
  "to": "+855716788123",
  "uri": "/2010-04-01/Accounts/9fa4887d-02fd-40b5-a1d4-857d7e963b5a/Messages/bad38e8a-1084-4bc6-9976-801ce4d701e1"
}

02. Send a message with a Messaging Service

When sending a message with a Messaging Service, you must provide a recipient via the To parameter and content via the Body parameter. In addition, you must provide the MessagingServiceSid.

If you provide a MessagingServiceSid and no From parameter, the optimal From value wil be determined from your Sender Pool. In this case, the Message resource's initial Status value is accepted.

Optionally, you can provide aMessagingServiceSid and a From parameter. The From parameter must be a sender from your Messaging Service's Sender Pool. In this case, the Message resource's initial Status value is queued.

With Messaging Services, you can also schedule messages to be sent in the future.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/285693fe-60f6-4f73-9f35-3053d1576dd8/Messages" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u 285693fe-60f6-4f73-9f35-3053d1576dd8:AuthToken \
    --data-urlencode "To=+855716788123" \
    --data-urlencode "MessagingServiceSid=553a6a40-76a6-493b-989e-7cb7eca761c5" \
    --data-urlencode "Body=Hello World"

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Messages

POST https://api.somleng.org/2010-04-01/Accounts/285693fe-60f6-4f73-9f35-3053d1576dd8/Messages

Parameters

{
  "To": "+855716788123",
  "MessagingServiceSid": "553a6a40-76a6-493b-989e-7cb7eca761c5",
  "Body": "Hello World"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account creating the Message resource.
From	Request Body Parameter: A phone number in E.164 format. Required if MessagingServiceSid is not passed
MessagingServiceSid	Request Body Parameter: The SID of the Messaging Service you want to associate with the Message. Set this parameter to use the Messaging Service Settings you have configured and leave the `From` parameter empty. When only this parameter is set, we will select the `From` phone number for delivery.
Body required	Request Body Parameter: The text of the message you want to send. Can be up to 1,600 characters in length.
To required	Request Body Parameter: The destination phone number in E.164 format
StatusCallback	Request Body Parameter: The URL we should call to send status information to your application. If specified, we POST these message status changes to the URL: `queued`, `failed`, `sent`, `delivered`, or `undelivered`. Somleng will POST its standard request parameters as well as some additional parameters including `MessageSid`, `MessageStatus`, and `ErrorCode`. URLs must contain a valid hostname (underscores are not permitted).
StatusCallbackMethod	Request Body Parameter: The HTTP method we should use when calling the `status_callback` URL. Can be: `GET` or `POST` and the default is `POST`.
ValidityPeriod	Request Body Parameter: How long in seconds the message can remain in our outgoing message queue. After this period elapses, the message fails and we call your status callback. Can be between 1 and the default value of 14,400 seconds. After a message has been accepted by a carrier, however, we cannot guarantee that the message will not be queued after this period. We recommend that this value be at least 5 seconds.
SmartEncoded	Request Body Parameter: Whether to detect Unicode characters that have a similar GSM-7 character and replace them. Can be: `true` or `false`.
ScheduleType	Request Body Parameter: Indicates your intent to schedule a message. Pass the value `fixed` to schedule a message at a fixed time.
SendAt	Request Body Parameter: The time that we will send the message. Must be in ISO 8601 format.

Response


201 Created

{
  "api_version": "2010-04-01",
  "sid": "f693acd5-a8cd-4674-95d4-5d4446e6abda",
  "date_created": "Mon, 16 Dec 2024 00:58:25 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:58:25 -0000",
  "account_sid": "285693fe-60f6-4f73-9f35-3053d1576dd8",
  "body": "Hello World",
  "date_sent": null,
  "direction": "outbound-api",
  "error_code": null,
  "error_message": null,
  "from": null,
  "messaging_service_sid": "553a6a40-76a6-493b-989e-7cb7eca761c5",
  "num_media": "0",
  "num_segments": "1",
  "price": null,
  "price_unit": null,
  "status": "accepted",
  "subresource_uris": {},
  "tags": {},
  "to": "+855716788123",
  "uri": "/2010-04-01/Accounts/285693fe-60f6-4f73-9f35-3053d1576dd8/Messages/f693acd5-a8cd-4674-95d4-5d4446e6abda"
}

03. Schedule a Message

The example below shows how to schedule a Message to be sent in the future.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/8fdeaa94-4673-4e35-8424-1f741228b831/Messages" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u 8fdeaa94-4673-4e35-8424-1f741228b831:AuthToken \
    --data-urlencode "To=+855716788123" \
    --data-urlencode "Body=Hello World" \
    --data-urlencode "SendAt=2024-12-21T00:58:25Z" \
    --data-urlencode "ScheduleType=fixed" \
    --data-urlencode "MessagingServiceSid=3f4233f5-8d0b-43e5-8cd3-407fded3229e"

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Messages

POST https://api.somleng.org/2010-04-01/Accounts/8fdeaa94-4673-4e35-8424-1f741228b831/Messages

Parameters

{
  "To": "+855716788123",
  "Body": "Hello World",
  "SendAt": "2024-12-21T00:58:25Z",
  "ScheduleType": "fixed",
  "MessagingServiceSid": "3f4233f5-8d0b-43e5-8cd3-407fded3229e"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account creating the Message resource.
From	Request Body Parameter: A phone number in E.164 format. Required if MessagingServiceSid is not passed
MessagingServiceSid	Request Body Parameter: The SID of the Messaging Service you want to associate with the Message. Set this parameter to use the Messaging Service Settings you have configured and leave the `From` parameter empty. When only this parameter is set, we will select the `From` phone number for delivery.
Body required	Request Body Parameter: The text of the message you want to send. Can be up to 1,600 characters in length.
To required	Request Body Parameter: The destination phone number in E.164 format
StatusCallback	Request Body Parameter: The URL we should call to send status information to your application. If specified, we POST these message status changes to the URL: `queued`, `failed`, `sent`, `delivered`, or `undelivered`. Somleng will POST its standard request parameters as well as some additional parameters including `MessageSid`, `MessageStatus`, and `ErrorCode`. URLs must contain a valid hostname (underscores are not permitted).
StatusCallbackMethod	Request Body Parameter: The HTTP method we should use when calling the `status_callback` URL. Can be: `GET` or `POST` and the default is `POST`.
ValidityPeriod	Request Body Parameter: How long in seconds the message can remain in our outgoing message queue. After this period elapses, the message fails and we call your status callback. Can be between 1 and the default value of 14,400 seconds. After a message has been accepted by a carrier, however, we cannot guarantee that the message will not be queued after this period. We recommend that this value be at least 5 seconds.
SmartEncoded	Request Body Parameter: Whether to detect Unicode characters that have a similar GSM-7 character and replace them. Can be: `true` or `false`.
ScheduleType	Request Body Parameter: Indicates your intent to schedule a message. Pass the value `fixed` to schedule a message at a fixed time.
SendAt	Request Body Parameter: The time that we will send the message. Must be in ISO 8601 format.

Response


201 Created

{
  "api_version": "2010-04-01",
  "sid": "2e244e86-f88a-4496-ad18-22e7b2f50e9f",
  "date_created": "Mon, 16 Dec 2024 00:58:25 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:58:25 -0000",
  "account_sid": "8fdeaa94-4673-4e35-8424-1f741228b831",
  "body": "Hello World",
  "date_sent": null,
  "direction": "outbound-api",
  "error_code": null,
  "error_message": null,
  "from": null,
  "messaging_service_sid": "3f4233f5-8d0b-43e5-8cd3-407fded3229e",
  "num_media": "0",
  "num_segments": "1",
  "price": null,
  "price_unit": null,
  "status": "scheduled",
  "subresource_uris": {},
  "tags": {},
  "to": "+855716788123",
  "uri": "/2010-04-01/Accounts/8fdeaa94-4673-4e35-8424-1f741228b831/Messages/2e244e86-f88a-4496-ad18-22e7b2f50e9f"
}

04. Fetch a Message

Returns a single Message resource specified by the provided Message SID.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/bbc6ee20-c2c4-4ed1-8603-db01eae708b6/Messages/80731cc0-3310-48d6-954a-2748679d434b" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u bbc6ee20-c2c4-4ed1-8603-db01eae708b6:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Messages/:Sid

GET https://api.somleng.org/2010-04-01/Accounts/bbc6ee20-c2c4-4ed1-8603-db01eae708b6/Messages/80731cc0-3310-48d6-954a-2748679d434b

Parameters

{}

Name	Description
AccountSid	Path Parameter: The SID of the Account associated with the Message resource.
Sid	Path Parameter: The SID of the Message resource to be fetched.

Response


200 OK

{
  "api_version": "2010-04-01",
  "sid": "80731cc0-3310-48d6-954a-2748679d434b",
  "date_created": "Mon, 16 Dec 2024 00:58:25 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:58:25 -0000",
  "account_sid": "bbc6ee20-c2c4-4ed1-8603-db01eae708b6",
  "body": "Hello World",
  "date_sent": null,
  "direction": "outbound-api",
  "error_code": null,
  "error_message": null,
  "from": "2442",
  "messaging_service_sid": null,
  "num_media": "0",
  "num_segments": "1",
  "price": null,
  "price_unit": null,
  "status": "accepted",
  "subresource_uris": {},
  "tags": {},
  "to": "+85512334667",
  "uri": "/2010-04-01/Accounts/bbc6ee20-c2c4-4ed1-8603-db01eae708b6/Messages/80731cc0-3310-48d6-954a-2748679d434b"
}

05. List all messages

Returns a list of all Message resources associated with your Account

Request

curl "https://api.somleng.org/2010-04-01/Accounts/8bdd4505-aed6-4373-ba9d-9685b371a2d5/Messages" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u 8bdd4505-aed6-4373-ba9d-9685b371a2d5:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Messages

GET https://api.somleng.org/2010-04-01/Accounts/8bdd4505-aed6-4373-ba9d-9685b371a2d5/Messages

Parameters

{}

Name	Description
AccountSid	Path Parameter: The SID of the Account associated with the Message resources.

Response


200 OK

{
  "messages": [
    {
      "api_version": "2010-04-01",
      "sid": "f05d2b09-ed64-4f61-855c-5bec0ce4d8df",
      "date_created": "Mon, 16 Dec 2024 00:58:24 -0000",
      "date_updated": "Mon, 16 Dec 2024 00:58:24 -0000",
      "account_sid": "8bdd4505-aed6-4373-ba9d-9685b371a2d5",
      "body": "Hello World",
      "date_sent": null,
      "direction": "outbound-api",
      "error_code": null,
      "error_message": null,
      "from": "2442",
      "messaging_service_sid": null,
      "num_media": "0",
      "num_segments": "1",
      "price": null,
      "price_unit": null,
      "status": "accepted",
      "subresource_uris": {},
      "tags": {},
      "to": "+85512334667",
      "uri": "/2010-04-01/Accounts/8bdd4505-aed6-4373-ba9d-9685b371a2d5/Messages/f05d2b09-ed64-4f61-855c-5bec0ce4d8df"
    }
  ],
  "uri": "/2010-04-01/Accounts/8bdd4505-aed6-4373-ba9d-9685b371a2d5/Messages",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/8bdd4505-aed6-4373-ba9d-9685b371a2d5/Messages?Page=0",
  "previous_page_uri": "/2010-04-01/Accounts/8bdd4505-aed6-4373-ba9d-9685b371a2d5/Messages?Page=0&PageToken=PBf05d2b09-ed64-4f61-855c-5bec0ce4d8df",
  "next_page_uri": null
}

06. Redact a message

This action can be used to redact messages: to do so, POST to the above URI and set the Body parameter as an empty string: "". This will allow you to effectively redact the text of a message while keeping the other message resource properties intact.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/ed4f23ea-b043-416d-8e66-71a0d9e4224c/Messages/712b1ce9-6053-4859-ae64-e410de378bf3" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u ed4f23ea-b043-416d-8e66-71a0d9e4224c:AuthToken \
    --data-urlencode "Body="

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Messages/:Sid

POST https://api.somleng.org/2010-04-01/Accounts/ed4f23ea-b043-416d-8e66-71a0d9e4224c/Messages/712b1ce9-6053-4859-ae64-e410de378bf3

Parameters

{
  "Body": ""
}

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the Message resources to update.
Sid	Path Parameter: The SID of the Message resource to be updated.
Body	Request Body Parameter: The new body of the Message resource. To redact the text content of a Message, this parameter's value must be an empty string
Status	Request Body Parameter: Set as `canceled` to prevent a not-yet-sent Message from being sent. Can be used to cancel sending a scheduled Message.

Response


200 OK

{
  "api_version": "2010-04-01",
  "sid": "712b1ce9-6053-4859-ae64-e410de378bf3",
  "date_created": "Mon, 16 Dec 2024 00:58:24 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:58:24 -0000",
  "account_sid": "ed4f23ea-b043-416d-8e66-71a0d9e4224c",
  "body": "",
  "date_sent": "Mon, 16 Dec 2024 00:58:24 -0000",
  "direction": "outbound-api",
  "error_code": null,
  "error_message": null,
  "from": "2442",
  "messaging_service_sid": null,
  "num_media": "0",
  "num_segments": "1",
  "price": null,
  "price_unit": null,
  "status": "sent",
  "subresource_uris": {},
  "tags": {},
  "to": "+85512334667",
  "uri": "/2010-04-01/Accounts/ed4f23ea-b043-416d-8e66-71a0d9e4224c/Messages/712b1ce9-6053-4859-ae64-e410de378bf3"
}

07. Cancel a scheduled message

Before you use this functionality:

Ensure the status value of canceled is spelled with one "l", (canceled) and not two (cancelled).
Ensure that you store the MessageSid of the messages you schedule. You need to reference the MessageSid for each message cancelation request.
There is no bulk cancelation. If you'd like to cancel multiple messages, you must send in a cancelation request for each message and reference the MessageSid.
There is a new status callback event for Canceled. You can continue to receive existing callback events by including the optional StatusCallBack parameter in the message request.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/da786cd4-fa8e-4ce1-8a5b-e208c23ea39b/Messages/7a26da73-3c3f-438d-9534-d005a318a6b6" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u da786cd4-fa8e-4ce1-8a5b-e208c23ea39b:AuthToken \
    --data-urlencode "Status=canceled"

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Messages/:Sid

POST https://api.somleng.org/2010-04-01/Accounts/da786cd4-fa8e-4ce1-8a5b-e208c23ea39b/Messages/7a26da73-3c3f-438d-9534-d005a318a6b6

Parameters

{
  "Status": "canceled"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the Message resources to update.
Sid	Path Parameter: The SID of the Message resource to be updated.
Body	Request Body Parameter: The new body of the Message resource. To redact the text content of a Message, this parameter's value must be an empty string
Status	Request Body Parameter: Set as `canceled` to prevent a not-yet-sent Message from being sent. Can be used to cancel sending a scheduled Message.

Response


200 OK

{
  "api_version": "2010-04-01",
  "sid": "7a26da73-3c3f-438d-9534-d005a318a6b6",
  "date_created": "Mon, 16 Dec 2024 00:58:24 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:58:24 -0000",
  "account_sid": "da786cd4-fa8e-4ce1-8a5b-e208c23ea39b",
  "body": "Hello World",
  "date_sent": null,
  "direction": "outbound-api",
  "error_code": null,
  "error_message": null,
  "from": null,
  "messaging_service_sid": "d07ba0d6-687d-43e0-b423-a03f762d552d",
  "num_media": "0",
  "num_segments": "1",
  "price": null,
  "price_unit": null,
  "status": "canceled",
  "subresource_uris": {},
  "tags": {},
  "to": "+85512334667",
  "uri": "/2010-04-01/Accounts/da786cd4-fa8e-4ce1-8a5b-e208c23ea39b/Messages/7a26da73-3c3f-438d-9534-d005a318a6b6"
}

08. Delete a Message

To delete a Message resource, send a DELETE request to the Message resource's URI.

If the DELETE request is successful, the response status code is HTTP 204 (No Content).

A deleted Message resource no longer appears in your Account's Messaging logs. Deleted messages cannot be recovered.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/b24cff19-56b2-4929-b89c-1e608b4338f1/Messages/d60d42e0-a613-4eca-b941-16fa29895bf1" -d '' -X DELETE \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u b24cff19-56b2-4929-b89c-1e608b4338f1:AuthToken

Endpoint

DELETE https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Messages/:Sid

DELETE https://api.somleng.org/2010-04-01/Accounts/b24cff19-56b2-4929-b89c-1e608b4338f1/Messages/d60d42e0-a613-4eca-b941-16fa29895bf1

Parameters

{}

Name	Description
AccountSid	Path Parameter: The SID of the Account associated with the Message resource.
Sid	Path Parameter: The SID of the Message resource you wish to delete.

Response


204 No Content

Pagination

When fetching multiple pages of API results, use the provided next_page_uri parameter to retrieve the next page of results.

01. List Resources

Some resources are lists of other resources. For example, the Calls list resource returns a list of calls. There are several important things to know about using and manipulating these lists.

Pagination Information

Property	Description
uri	The URI of the current page.
first_page_uri	The URI for the first page of this list.
next_page_uri	The URI for the next page of this list.
previous_page_uri	The URI for the previous page of this list.
page	The current page number. Zero-indexed, so the first page is 0.
page_size	How many items are in each page

Paging Through API Resources

When fetching multiple pages of API results, use the provided next_page_uri parameter to retrieve the next page of results.

You can control the size of pages with the PageSize parameter.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/20f53ce5-0823-48c4-9c19-91fe1b165daa/Calls?PageSize=2" \
    -u 20f53ce5-0823-48c4-9c19-91fe1b165daa:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Calls

GET https://api.somleng.org/2010-04-01/Accounts/20f53ce5-0823-48c4-9c19-91fe1b165daa/Calls?PageSize=2

Parameters

{
  "PageSize": "2"
}

Name	Description
PageSize	How many resources to return in each list page. The default is 50, and the maximum is 100.

Response


200 OK

{
  "calls": [
    {
      "api_version": "2010-04-01",
      "sid": "30a7871d-a59b-4a9e-9426-056c5bad4f4e",
      "date_created": "Mon, 16 Dec 2024 00:57:47 -0000",
      "date_updated": "Mon, 16 Dec 2024 00:57:47 -0000",
      "account_sid": "20f53ce5-0823-48c4-9c19-91fe1b165daa",
      "annotation": null,
      "answered_by": null,
      "caller_name": null,
      "direction": "outbound-api",
      "duration": null,
      "end_time": null,
      "forwarded_from": null,
      "from": "2442",
      "from_formatted": "2442",
      "group_sid": null,
      "parent_call_sid": null,
      "phone_number_sid": null,
      "price": null,
      "price_unit": null,
      "start_time": null,
      "status": "queued",
      "subresource_uris": {},
      "to": "+85512334667",
      "to_formatted": "+855 12 334 667",
      "uri": "/2010-04-01/Accounts/20f53ce5-0823-48c4-9c19-91fe1b165daa/Calls/30a7871d-a59b-4a9e-9426-056c5bad4f4e"
    },
    {
      "api_version": "2010-04-01",
      "sid": "9fdd1dc2-0cdf-4c90-9728-86ad53ddbab0",
      "date_created": "Mon, 16 Dec 2024 00:57:47 -0000",
      "date_updated": "Mon, 16 Dec 2024 00:57:47 -0000",
      "account_sid": "20f53ce5-0823-48c4-9c19-91fe1b165daa",
      "annotation": null,
      "answered_by": null,
      "caller_name": null,
      "direction": "outbound-api",
      "duration": null,
      "end_time": null,
      "forwarded_from": null,
      "from": "2442",
      "from_formatted": "2442",
      "group_sid": null,
      "parent_call_sid": null,
      "phone_number_sid": null,
      "price": null,
      "price_unit": null,
      "start_time": null,
      "status": "queued",
      "subresource_uris": {},
      "to": "+85512334667",
      "to_formatted": "+855 12 334 667",
      "uri": "/2010-04-01/Accounts/20f53ce5-0823-48c4-9c19-91fe1b165daa/Calls/9fdd1dc2-0cdf-4c90-9728-86ad53ddbab0"
    }
  ],
  "uri": "/2010-04-01/Accounts/20f53ce5-0823-48c4-9c19-91fe1b165daa/Calls?PageSize=2",
  "page": 0,
  "page_size": 2,
  "first_page_uri": "/2010-04-01/Accounts/20f53ce5-0823-48c4-9c19-91fe1b165daa/Calls?Page=0&PageSize=2",
  "previous_page_uri": "/2010-04-01/Accounts/20f53ce5-0823-48c4-9c19-91fe1b165daa/Calls?Page=0&PageSize=2&PageToken=PB30a7871d-a59b-4a9e-9426-056c5bad4f4e",
  "next_page_uri": "/2010-04-01/Accounts/20f53ce5-0823-48c4-9c19-91fe1b165daa/Calls?Page=1&PageSize=2&PageToken=PA9fdd1dc2-0cdf-4c90-9728-86ad53ddbab0"
}

Phone Calls

01. Create a call

Calls can be made via the REST API to phone numbers. To place a new outbound call, make an HTTP POST request to your account's Call resource.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/44bb773e-933e-4644-b65c-275a43ed2082/Calls" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u 44bb773e-933e-4644-b65c-275a43ed2082:AuthToken \
    --data-urlencode "To=+299221234" \
    --data-urlencode "From=+12513095500" \
    --data-urlencode "Url=https://demo.twilio.com/docs/voice.xml"

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Calls

POST https://api.somleng.org/2010-04-01/Accounts/44bb773e-933e-4644-b65c-275a43ed2082/Calls

Parameters

{
  "To": "+299221234",
  "From": "+12513095500",
  "Url": "https://demo.twilio.com/docs/voice.xml"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account that will create the resource.
To required	Request Body Parameter: The phone number to call.
From required	Request Body Parameter: The phone number to use as the caller id.
Url	Request Body Parameter: The absolute URL that returns the TwiML instructions for the call. We will call this URL using the `method` when the call connects.
Method	The HTTP method we should use when calling the url parameter's value. Can be: `GET` or `POST` and the default is `POST`.
Twiml	Request Body Parameter: TwiML instructions for the call to be used without fetching TwiML from `Url` parameter. If both `Twiml` and `Url` are provided then `Twiml` parameter will be ignored.
StatusCallback	Request Body Parameter: The URL we should call using the `status_callback_method` to send status information to your application. URLs must contain a valid hostname (underscores are not permitted).
StatusCallbackMethod	Request Body Parameter: The HTTP method we should use when calling the `status_callback` URL. Can be: `GET` or `POST` and the default is `POST`.

Response


201 Created

{
  "api_version": "2010-04-01",
  "sid": "854d8daf-1c82-4a25-b95a-de6e82049e73",
  "date_created": "Mon, 16 Dec 2024 00:57:44 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:57:44 -0000",
  "account_sid": "44bb773e-933e-4644-b65c-275a43ed2082",
  "annotation": null,
  "answered_by": null,
  "caller_name": null,
  "direction": "outbound-api",
  "duration": null,
  "end_time": null,
  "forwarded_from": null,
  "from": "+12513095500",
  "from_formatted": "+1 (251) 309-5500",
  "group_sid": null,
  "parent_call_sid": null,
  "phone_number_sid": "4cd70a1e-73be-4651-be70-ab3d7dcbad91",
  "price": null,
  "price_unit": null,
  "start_time": null,
  "status": "queued",
  "subresource_uris": {},
  "to": "+299221234",
  "to_formatted": "+299 22 1234",
  "uri": "/2010-04-01/Accounts/44bb773e-933e-4644-b65c-275a43ed2082/Calls/854d8daf-1c82-4a25-b95a-de6e82049e73"
}

02. Fetch a call

This API call returns the Call resource of an individual call, identified by its Sid.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/3498ed40-fe9c-46ba-bfef-1d37f8609256/Calls/3074ee4a-4404-4d3a-ac28-415fc1721ec9" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u 3498ed40-fe9c-46ba-bfef-1d37f8609256:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Calls/:Sid

GET https://api.somleng.org/2010-04-01/Accounts/3498ed40-fe9c-46ba-bfef-1d37f8609256/Calls/3074ee4a-4404-4d3a-ac28-415fc1721ec9

Parameters

{}

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the Call resource(s) to fetch.
Sid	Path Parameter: The SID of the Call resource to fetch.

Response


200 OK

{
  "api_version": "2010-04-01",
  "sid": "3074ee4a-4404-4d3a-ac28-415fc1721ec9",
  "date_created": "Mon, 16 Dec 2024 00:57:44 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:57:44 -0000",
  "account_sid": "3498ed40-fe9c-46ba-bfef-1d37f8609256",
  "annotation": null,
  "answered_by": null,
  "caller_name": null,
  "direction": "outbound-api",
  "duration": null,
  "end_time": null,
  "forwarded_from": null,
  "from": "2442",
  "from_formatted": "2442",
  "group_sid": null,
  "parent_call_sid": null,
  "phone_number_sid": null,
  "price": null,
  "price_unit": null,
  "start_time": null,
  "status": "queued",
  "subresource_uris": {},
  "to": "+85512334667",
  "to_formatted": "+855 12 334 667",
  "uri": "/2010-04-01/Accounts/3498ed40-fe9c-46ba-bfef-1d37f8609256/Calls/3074ee4a-4404-4d3a-ac28-415fc1721ec9"
}

03. List phone calls

Return a list of phone calls made to and from an account, identified by its AccountSid.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/295f1539-b5f3-4e61-a34a-725e1ccdd73f/Calls" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u 295f1539-b5f3-4e61-a34a-725e1ccdd73f:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Calls

GET https://api.somleng.org/2010-04-01/Accounts/295f1539-b5f3-4e61-a34a-725e1ccdd73f/Calls

Parameters

{}

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the Call resource(s) to read.

Response


200 OK

{
  "calls": [
    {
      "api_version": "2010-04-01",
      "sid": "cdc7e222-d0c3-48a3-b7ee-f0c91896fbd9",
      "date_created": "Mon, 16 Dec 2024 00:57:44 -0000",
      "date_updated": "Mon, 16 Dec 2024 00:57:44 -0000",
      "account_sid": "295f1539-b5f3-4e61-a34a-725e1ccdd73f",
      "annotation": null,
      "answered_by": null,
      "caller_name": null,
      "direction": "outbound-api",
      "duration": null,
      "end_time": null,
      "forwarded_from": null,
      "from": "2442",
      "from_formatted": "2442",
      "group_sid": null,
      "parent_call_sid": null,
      "phone_number_sid": null,
      "price": null,
      "price_unit": null,
      "start_time": null,
      "status": "queued",
      "subresource_uris": {},
      "to": "+85512334667",
      "to_formatted": "+855 12 334 667",
      "uri": "/2010-04-01/Accounts/295f1539-b5f3-4e61-a34a-725e1ccdd73f/Calls/cdc7e222-d0c3-48a3-b7ee-f0c91896fbd9"
    }
  ],
  "uri": "/2010-04-01/Accounts/295f1539-b5f3-4e61-a34a-725e1ccdd73f/Calls",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/295f1539-b5f3-4e61-a34a-725e1ccdd73f/Calls?Page=0",
  "previous_page_uri": "/2010-04-01/Accounts/295f1539-b5f3-4e61-a34a-725e1ccdd73f/Calls?Page=0&PageToken=PBcdc7e222-d0c3-48a3-b7ee-f0c91896fbd9",
  "next_page_uri": null
}

04. Update a Call in progress with TwiML

Updating a Call resource allows you to modify an active call.

Real-time call modification allows you to interrupt an in-progress call and terminate it or have it begin processing TwiML from either a new URL or from the TwiML provided with modification. Call modification is useful for any application where you want to change the behavior of a running call asynchronously, e.g., hold music, call queues, transferring calls, or forcing a hangup.

By sending an HTTP POST request to a specific Call instance, you can redirect a call that is in progress or you can terminate a call.

This example interrupts an in-progress call and begins processing TwiML from a the TwiML provided.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/5f43e448-68d9-47d1-a951-5380a377a1fa/Calls/75599f33-21a2-44a8-9141-006d528d1a7d" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u 5f43e448-68d9-47d1-a951-5380a377a1fa:AuthToken \
    --data-urlencode "Twiml=<Response><Say>Ahoy there</Say></Response>"

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Calls/:Sid

POST https://api.somleng.org/2010-04-01/Accounts/5f43e448-68d9-47d1-a951-5380a377a1fa/Calls/75599f33-21a2-44a8-9141-006d528d1a7d

Parameters

{
  "Twiml": "<Response><Say>Ahoy there</Say></Response>"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the Call resource(s) to update.
Sid	Path Parameter: The ID that uniquely identifies the Call resource to update.
Url	Request Body Parameter: The absolute URL that returns the TwiML instructions for the call. We will call this URL using the method when the call connects.
Method	Request Body Parameter: The HTTP method we should use when calling the url. Can be: `GET` or `POST` and the default is `POST`.
StatusCallback	Request Body Parameter: The URL we should call using the `status_callback_method` to send status information to your application. URLs must contain a valid hostname (underscores are not permitted).
StatusCallbackMethod	Request Body Parameter: The HTTP method we should use when requesting the `status_callback` URL. Can be: `GET` or `POST` and the default is `POST`.
Twiml	Request Body Parameter: TwiML instructions for the call to be used without fetching Twiml from url. `Twiml` and `Url` parameters are mutually exclusive.
Status	Request Body Parameter: The new status of the resource. Can be: `canceled` or `completed`. Specifying `canceled` will attempt to hang up calls that are `queued` or `ringing`; however, it will not affect calls already in progress. Specifying `completed` will attempt to hang up a call even if it's already in progress.

Response


200 OK

{
  "api_version": "2010-04-01",
  "sid": "75599f33-21a2-44a8-9141-006d528d1a7d",
  "date_created": "Mon, 16 Dec 2024 00:57:44 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:57:44 -0000",
  "account_sid": "5f43e448-68d9-47d1-a951-5380a377a1fa",
  "annotation": null,
  "answered_by": null,
  "caller_name": null,
  "direction": "outbound-api",
  "duration": null,
  "end_time": null,
  "forwarded_from": null,
  "from": "2442",
  "from_formatted": "2442",
  "group_sid": null,
  "parent_call_sid": null,
  "phone_number_sid": null,
  "price": null,
  "price_unit": null,
  "start_time": null,
  "status": "in-progress",
  "subresource_uris": {},
  "to": "+85512334667",
  "to_formatted": "+855 12 334 667",
  "uri": "/2010-04-01/Accounts/5f43e448-68d9-47d1-a951-5380a377a1fa/Calls/75599f33-21a2-44a8-9141-006d528d1a7d"
}

05. Update a Call in progress with URL

This example interrupts an in-progress call and begins processing TwiML from a new URL.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/afb340af-37df-4455-930d-a5000314b94f/Calls/867d9497-0aa7-4d86-b7b4-00015406e02b" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u afb340af-37df-4455-930d-a5000314b94f:AuthToken \
    --data-urlencode "Url=https://demo.twilio.com/docs/voice.xml" \
    --data-urlencode "Method=POST"

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Calls/:Sid

POST https://api.somleng.org/2010-04-01/Accounts/afb340af-37df-4455-930d-a5000314b94f/Calls/867d9497-0aa7-4d86-b7b4-00015406e02b

Parameters

{
  "Url": "https://demo.twilio.com/docs/voice.xml",
  "Method": "POST"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the Call resource(s) to update.
Sid	Path Parameter: The ID that uniquely identifies the Call resource to update.
Url	Request Body Parameter: The absolute URL that returns the TwiML instructions for the call. We will call this URL using the method when the call connects.
Method	Request Body Parameter: The HTTP method we should use when calling the url. Can be: `GET` or `POST` and the default is `POST`.
StatusCallback	Request Body Parameter: The URL we should call using the `status_callback_method` to send status information to your application. URLs must contain a valid hostname (underscores are not permitted).
StatusCallbackMethod	Request Body Parameter: The HTTP method we should use when requesting the `status_callback` URL. Can be: `GET` or `POST` and the default is `POST`.
Twiml	Request Body Parameter: TwiML instructions for the call to be used without fetching Twiml from url. `Twiml` and `Url` parameters are mutually exclusive.
Status	Request Body Parameter: The new status of the resource. Can be: `canceled` or `completed`. Specifying `canceled` will attempt to hang up calls that are `queued` or `ringing`; however, it will not affect calls already in progress. Specifying `completed` will attempt to hang up a call even if it's already in progress.

Response


200 OK

{
  "api_version": "2010-04-01",
  "sid": "867d9497-0aa7-4d86-b7b4-00015406e02b",
  "date_created": "Mon, 16 Dec 2024 00:57:44 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:57:44 -0000",
  "account_sid": "afb340af-37df-4455-930d-a5000314b94f",
  "annotation": null,
  "answered_by": null,
  "caller_name": null,
  "direction": "outbound-api",
  "duration": null,
  "end_time": null,
  "forwarded_from": null,
  "from": "2442",
  "from_formatted": "2442",
  "group_sid": null,
  "parent_call_sid": null,
  "phone_number_sid": null,
  "price": null,
  "price_unit": null,
  "start_time": null,
  "status": "in-progress",
  "subresource_uris": {},
  "to": "+85512334667",
  "to_formatted": "+855 12 334 667",
  "uri": "/2010-04-01/Accounts/afb340af-37df-4455-930d-a5000314b94f/Calls/867d9497-0aa7-4d86-b7b4-00015406e02b"
}

06. End a call

This example interrupts an in-progress call and terminates it.

Request

curl -X POST "https://api.somleng.org/2010-04-01/Accounts/40769a0f-1e18-43de-b97c-1b6cd966755c/Calls/b3463bca-8301-45ac-9b86-8924f38f0e63" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -u 40769a0f-1e18-43de-b97c-1b6cd966755c:AuthToken \
    --data-urlencode "Status=completed"

Endpoint

POST https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Calls/:Sid

POST https://api.somleng.org/2010-04-01/Accounts/40769a0f-1e18-43de-b97c-1b6cd966755c/Calls/b3463bca-8301-45ac-9b86-8924f38f0e63

Parameters

{
  "Status": "completed"
}

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the Call resource(s) to update.
Sid	Path Parameter: The ID that uniquely identifies the Call resource to update.
Url	Request Body Parameter: The absolute URL that returns the TwiML instructions for the call. We will call this URL using the method when the call connects.
Method	Request Body Parameter: The HTTP method we should use when calling the url. Can be: `GET` or `POST` and the default is `POST`.
StatusCallback	Request Body Parameter: The URL we should call using the `status_callback_method` to send status information to your application. URLs must contain a valid hostname (underscores are not permitted).
StatusCallbackMethod	Request Body Parameter: The HTTP method we should use when requesting the `status_callback` URL. Can be: `GET` or `POST` and the default is `POST`.
Twiml	Request Body Parameter: TwiML instructions for the call to be used without fetching Twiml from url. `Twiml` and `Url` parameters are mutually exclusive.
Status	Request Body Parameter: The new status of the resource. Can be: `canceled` or `completed`. Specifying `canceled` will attempt to hang up calls that are `queued` or `ringing`; however, it will not affect calls already in progress. Specifying `completed` will attempt to hang up a call even if it's already in progress.

Response


200 OK

{
  "api_version": "2010-04-01",
  "sid": "b3463bca-8301-45ac-9b86-8924f38f0e63",
  "date_created": "Mon, 16 Dec 2024 00:57:44 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:57:44 -0000",
  "account_sid": "40769a0f-1e18-43de-b97c-1b6cd966755c",
  "annotation": null,
  "answered_by": null,
  "caller_name": null,
  "direction": "outbound-api",
  "duration": null,
  "end_time": null,
  "forwarded_from": null,
  "from": "2442",
  "from_formatted": "2442",
  "group_sid": null,
  "parent_call_sid": null,
  "phone_number_sid": null,
  "price": null,
  "price_unit": null,
  "start_time": null,
  "status": "in-progress",
  "subresource_uris": {},
  "to": "+85512334667",
  "to_formatted": "+855 12 334 667",
  "uri": "/2010-04-01/Accounts/40769a0f-1e18-43de-b97c-1b6cd966755c/Calls/b3463bca-8301-45ac-9b86-8924f38f0e63"
}

Recordings

01. Fetch a Recording's media file

You can fetch a Recording's media file by appending .wav or .mp3 to the Recording Resource's URI.

It's only possible to fetch a Recording's media file when the Recording's status is completed.

If the media associated with a Recording Resource is not available, the request returns 404 Not Found.

Without an extension, or with a .wav, a binary WAV audio file is returned with mime-type audio/x-wav.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/90f959b9-80d4-4359-a836-402f3c728191/Recordings/4f35c230-aa55-4566-a01b-ecde8cba8aa0"

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Recordings/:Sid

GET https://api.somleng.org/2010-04-01/Accounts/90f959b9-80d4-4359-a836-402f3c728191/Recordings/4f35c230-aa55-4566-a01b-ecde8cba8aa0

Parameters

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the Recording resource to fetch.
Sid	Path Parameter: The SID of the Recording resource to fetch.

Response


302 Found

02. Fetch a Recording as mp3

You can fetch a Recording's media file as mp3 by appending .mp3 to the Recording Resource's URI.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/cac36f61-3dd4-436e-9a7b-9b198762ba2d/Recordings/5d5c8e4a-cbcc-4e5f-909f-ca41dde2fb10.mp3"

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Recordings/:Sid.mp3

GET https://api.somleng.org/2010-04-01/Accounts/cac36f61-3dd4-436e-9a7b-9b198762ba2d/Recordings/5d5c8e4a-cbcc-4e5f-909f-ca41dde2fb10.mp3

Parameters

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the Recording resource to fetch.
Sid	Path Parameter: The SID of the Recording resource to fetch.

Response


302 Found

03. Fetch a Recording's metadata

A Recording's metadata can be returned in JSON format. Append .json to the Recording Resource's URI.

Request

curl "https://api.somleng.org/2010-04-01/Accounts/ad208a1b-0746-45bc-9df6-d2ac750d5382/Recordings/b9245457-8dc4-4396-88a9-5c2a40bc3849.json"

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Recordings/:Sid.json

GET https://api.somleng.org/2010-04-01/Accounts/ad208a1b-0746-45bc-9df6-d2ac750d5382/Recordings/b9245457-8dc4-4396-88a9-5c2a40bc3849.json

Parameters

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the Recording resource to fetch.
Sid	Path Parameter: The SID of the Recording resource to fetch.

Response


200 OK

{
  "api_version": "2010-04-01",
  "sid": "b9245457-8dc4-4396-88a9-5c2a40bc3849",
  "date_created": "Mon, 16 Dec 2024 00:58:28 -0000",
  "date_updated": "Mon, 16 Dec 2024 00:58:28 -0000",
  "account_sid": "ad208a1b-0746-45bc-9df6-d2ac750d5382",
  "call_sid": "316ff7de-2ff2-433f-9377-e4ab1b1dc8e5",
  "conference_sid": null,
  "channels": 1,
  "start_time": "2024-12-16T00:58:28.536Z",
  "duration": null,
  "price": null,
  "price_unit": null,
  "source": "RecordVerb",
  "status": "processing",
  "error_code": null,
  "encryption_details": null,
  "track": "both",
  "uri": "/2010-04-01/Accounts/ad208a1b-0746-45bc-9df6-d2ac750d5382/Calls/316ff7de-2ff2-433f-9377-e4ab1b1dc8e5/Recordings/b9245457-8dc4-4396-88a9-5c2a40bc3849.json"
}

04. Get all recordings for a given call

Request

curl "https://api.somleng.org/2010-04-01/Accounts/7327eed9-3632-43b0-b83a-a72f0d5cd630/Calls/3d84206c-af23-40e0-a8a9-86309af2594f/Recordings" \
    -u 7327eed9-3632-43b0-b83a-a72f0d5cd630:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Calls/:CallSid/Recordings

GET https://api.somleng.org/2010-04-01/Accounts/7327eed9-3632-43b0-b83a-a72f0d5cd630/Calls/3d84206c-af23-40e0-a8a9-86309af2594f/Recordings

Parameters

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the Recording resource to read.
CallSid	Path Parameter: The Call SID of the Recording resources to read.

Response


200 OK

{
  "recordings": [
    {
      "api_version": "2010-04-01",
      "sid": "7f9914d8-6639-4d95-a410-b36cb0792285",
      "date_created": "Mon, 16 Dec 2024 00:58:28 -0000",
      "date_updated": "Mon, 16 Dec 2024 00:58:28 -0000",
      "account_sid": "7327eed9-3632-43b0-b83a-a72f0d5cd630",
      "call_sid": "3d84206c-af23-40e0-a8a9-86309af2594f",
      "conference_sid": null,
      "channels": 1,
      "start_time": "2024-12-16T00:58:28.804Z",
      "duration": "0",
      "price": null,
      "price_unit": null,
      "source": "RecordVerb",
      "status": "completed",
      "error_code": null,
      "encryption_details": null,
      "track": "both",
      "uri": "/2010-04-01/Accounts/7327eed9-3632-43b0-b83a-a72f0d5cd630/Calls/3d84206c-af23-40e0-a8a9-86309af2594f/Recordings/7f9914d8-6639-4d95-a410-b36cb0792285.json"
    }
  ],
  "uri": "/2010-04-01/Accounts/7327eed9-3632-43b0-b83a-a72f0d5cd630/Calls/3d84206c-af23-40e0-a8a9-86309af2594f/Recordings",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/7327eed9-3632-43b0-b83a-a72f0d5cd630/Calls/3d84206c-af23-40e0-a8a9-86309af2594f/Recordings?Page=0",
  "previous_page_uri": "/2010-04-01/Accounts/7327eed9-3632-43b0-b83a-a72f0d5cd630/Calls/3d84206c-af23-40e0-a8a9-86309af2594f/Recordings?Page=0&PageToken=PB7f9914d8-6639-4d95-a410-b36cb0792285",
  "next_page_uri": null
}

05. List recordings by account

Request

curl "https://api.somleng.org/2010-04-01/Accounts/ee7228fb-fa81-4167-9043-1cc322246ade/Recordings" \
    -u ee7228fb-fa81-4167-9043-1cc322246ade:AuthToken

Endpoint

GET https://api.somleng.org/2010-04-01/Accounts/:AccountSid/Recordings

GET https://api.somleng.org/2010-04-01/Accounts/ee7228fb-fa81-4167-9043-1cc322246ade/Recordings

Parameters

Name	Description
AccountSid	Path Parameter: The SID of the Account that created the Recording resource to read.

Response


200 OK

{
  "recordings": [
    {
      "api_version": "2010-04-01",
      "sid": "77bf130f-8261-44a6-b3aa-3308dedd28e7",
      "date_created": "Mon, 16 Dec 2024 00:58:28 -0000",
      "date_updated": "Mon, 16 Dec 2024 00:58:28 -0000",
      "account_sid": "ee7228fb-fa81-4167-9043-1cc322246ade",
      "call_sid": "a5113ab1-57de-49df-9bd9-00e438ad3bbd",
      "conference_sid": null,
      "channels": 1,
      "start_time": "2024-12-16T00:58:28.716Z",
      "duration": null,
      "price": null,
      "price_unit": null,
      "source": "RecordVerb",
      "status": "processing",
      "error_code": null,
      "encryption_details": null,
      "track": "both",
      "uri": "/2010-04-01/Accounts/ee7228fb-fa81-4167-9043-1cc322246ade/Calls/a5113ab1-57de-49df-9bd9-00e438ad3bbd/Recordings/77bf130f-8261-44a6-b3aa-3308dedd28e7.json"
    },
    {
      "api_version": "2010-04-01",
      "sid": "0605c06e-eb71-44f5-921b-f6a372a342f9",
      "date_created": "Mon, 16 Dec 2024 00:58:28 -0000",
      "date_updated": "Mon, 16 Dec 2024 00:58:28 -0000",
      "account_sid": "ee7228fb-fa81-4167-9043-1cc322246ade",
      "call_sid": "a0f5eaa3-def0-489b-bd29-af73a3880113",
      "conference_sid": null,
      "channels": 1,
      "start_time": "2024-12-16T00:58:28.689Z",
      "duration": null,
      "price": null,
      "price_unit": null,
      "source": "RecordVerb",
      "status": "processing",
      "error_code": null,
      "encryption_details": null,
      "track": "both",
      "uri": "/2010-04-01/Accounts/ee7228fb-fa81-4167-9043-1cc322246ade/Calls/a0f5eaa3-def0-489b-bd29-af73a3880113/Recordings/0605c06e-eb71-44f5-921b-f6a372a342f9.json"
    }
  ],
  "uri": "/2010-04-01/Accounts/ee7228fb-fa81-4167-9043-1cc322246ade/Recordings",
  "page": 0,
  "page_size": 50,
  "first_page_uri": "/2010-04-01/Accounts/ee7228fb-fa81-4167-9043-1cc322246ade/Recordings?Page=0",
  "previous_page_uri": "/2010-04-01/Accounts/ee7228fb-fa81-4167-9043-1cc322246ade/Recordings?Page=0&PageToken=PB77bf130f-8261-44a6-b3aa-3308dedd28e7",
  "next_page_uri": null
}

Verification Services

01. Create a Verification Service

A Verification Service is the set of common configurations used to create and check verifications. You can create a service with the API or in the Console.

Request

curl -X POST "https://verify.somleng.org/v2/Services" \
    -u 1fc969d2-6662-4244-ba02-a2da94850a2a:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "FriendlyName=My Verification Service"

Endpoint

POST https://verify.somleng.org/v2/Services

POST https://verify.somleng.org/v2/Services

Parameters

{
  "FriendlyName": "My Verification Service"
}

Name	Description
FriendlyName required	Request Body Parameter: A descriptive string that you create to describe the verification service. It can be up to 32 characters long.
CodeLength	Request Body Parameter: The length of the verification code to generate. Must be an integer value between 4 and 10, inclusive.

Response


201 Created

{
  "sid": "fb78a93b-1a62-4b77-a32b-0a89df8f625a",
  "account_sid": "1fc969d2-6662-4244-ba02-a2da94850a2a",
  "date_created": "2024-12-16T00:58:25Z",
  "date_updated": "2024-12-16T00:58:25Z",
  "friendly_name": "My Verification Service",
  "url": "http://verify.lvh.me/v2/Services/fb78a93b-1a62-4b77-a32b-0a89df8f625a",
  "code_length": 6
}

02. Fetch a Service

Request

curl "https://verify.somleng.org/v2/Services/1892c6f7-b7ee-46d0-94b9-61ce1cc94b98" \
    -u 972e0da2-896b-471a-bef0-456ad38d8fa3:AuthToken

Endpoint

GET https://verify.somleng.org/v2/Services/:Sid

GET https://verify.somleng.org/v2/Services/1892c6f7-b7ee-46d0-94b9-61ce1cc94b98

Parameters

Name	Description
Sid	Path Parameter: The SID of the Verification Service to fetch.

Response


200 OK

{
  "sid": "1892c6f7-b7ee-46d0-94b9-61ce1cc94b98",
  "account_sid": "972e0da2-896b-471a-bef0-456ad38d8fa3",
  "date_created": "2024-12-16T00:58:25Z",
  "date_updated": "2024-12-16T00:58:25Z",
  "friendly_name": "My Verification Service",
  "url": "http://verify.lvh.me/v2/Services/1892c6f7-b7ee-46d0-94b9-61ce1cc94b98",
  "code_length": 4
}

03. List all Services

Request

curl "https://verify.somleng.org/v2/Services" \
    -u 2ce7aa44-ec94-4d77-ac91-56d4b6ceb588:AuthToken

Endpoint

GET https://verify.somleng.org/v2/Services

GET https://verify.somleng.org/v2/Services

Parameters

None known.

Response


200 OK

{
  "services": [
    {
      "sid": "7e7cf962-c5b0-4ab5-afe5-fc9e58d1aaa6",
      "account_sid": "2ce7aa44-ec94-4d77-ac91-56d4b6ceb588",
      "date_created": "2024-12-16T00:58:25Z",
      "date_updated": "2024-12-16T00:58:25Z",
      "friendly_name": "My Verification Service",
      "url": "http://verify.lvh.me/v2/Services/7e7cf962-c5b0-4ab5-afe5-fc9e58d1aaa6",
      "code_length": 4
    }
  ],
  "meta": {
    "url": "https://verify.somleng.org/v2/Services",
    "page": 0,
    "page_size": 50,
    "first_page_url": "https://verify.somleng.org/v2/Services?Page=0",
    "previous_page_url": "https://verify.somleng.org/v2/Services?Page=0&PageToken=PB7e7cf962-c5b0-4ab5-afe5-fc9e58d1aaa6",
    "next_page_url": null,
    "key": "services"
  }
}

04. Update a Service

This example updates the FriendlyName and CodeLength of a Verification Service.

Request

curl -X POST "https://verify.somleng.org/v2/Services/7dcf1d93-0a17-4b53-9291-aed5d4213eac" \
    -u ed1aff2c-1783-480c-b5a6-d01bf049ad29:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "FriendlyName=Rocket Ride Service" \
    --data-urlencode "CodeLength=6"

Endpoint

POST https://verify.somleng.org/v2/Services/:sid

POST https://verify.somleng.org/v2/Services/7dcf1d93-0a17-4b53-9291-aed5d4213eac

Parameters

{
  "FriendlyName": "Rocket Ride Service",
  "CodeLength": "6"
}

Name	Description
Sid required	Path Parameter: The SID of the Verification Service to update.
FriendlyName required	Request Body Parameter: A descriptive string that you create to describe the Verification Service. It can be up to 32 characters long.
Request Body Parameter: CodeLength	The length of the verification code to generate. Must be an integer value between 4 and 10, inclusive.

Response


200 OK

{
  "sid": "7dcf1d93-0a17-4b53-9291-aed5d4213eac",
  "account_sid": "ed1aff2c-1783-480c-b5a6-d01bf049ad29",
  "date_created": "2024-12-16T00:58:25Z",
  "date_updated": "2024-12-16T00:58:25Z",
  "friendly_name": "Rocket Ride Service",
  "url": "http://verify.lvh.me/v2/Services/7dcf1d93-0a17-4b53-9291-aed5d4213eac",
  "code_length": 6
}

05. Delete a Service

Request

curl "https://verify.somleng.org/v2/Services/e1a4e9c5-5c65-4efb-a54f-ce0ea47253f7" -d '' -X DELETE \
    -u 311b4901-bd29-4795-8e74-0d3a69cb5e4e:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded"

Endpoint

DELETE https://verify.somleng.org/v2/Services/:Sid

DELETE https://verify.somleng.org/v2/Services/e1a4e9c5-5c65-4efb-a54f-ce0ea47253f7

Parameters

{}

Name	Description
Sid	Path Parameter: The SID of the Verification Service to delete.

Response


204 No Content

Verifications

01. Start a Verification with SMS

To verify a user's phone number, start by requesting to send a verification code to their device. Phone numbers must be in E.164 format.

Request

curl -X POST "https://verify.somleng.org/v2/Services/b0de6fba-6639-40fe-8c06-b6153371aa0a/Verifications" \
    -u 467ac6d6-c25a-4b89-848d-0d60619d01e4:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "To=+85512334667" \
    --data-urlencode "Channel=sms"

Endpoint

POST https://verify.somleng.org/v2/Services/:ServiceSid/Verifications

POST https://verify.somleng.org/v2/Services/b0de6fba-6639-40fe-8c06-b6153371aa0a/Verifications

Parameters

{
  "To": "+85512334667",
  "Channel": "sms"
}

Name	Description
ServiceSid	Path Parameter: The SID of the verification Service to create the resource under.
To required	Request Body Parameter: The phone number or email to verify. Phone numbers must be in E.164 format.
Channel required	Request Body Parameter: The verification method to use. One of: `sms` or `call`
Locale	Request Body Parameter: Locale will automatically resolve based on phone number country code of the recipient for SMS and call channel verifications. It will fallback to English if the selected translation is not available. This parameter will override the automatic locale resolution. The following locales are supported: `en`, `de`, `es`, `fr`, `it`, `ja`, `nl`, `pt`, `ar`, `ca`, `da`, `fi`, `id`, `ko`, `pl`, `ru`, `sv`, `tr`, `uk`, `vi`, `af`, `cs`, `el`, `hi`, `hr`, `hu`, `km`, `kn`, `lt`, `mr`, `ms`, `nb`, `pt-br`, `ro`, `sk`, `te`, `th`, `tl`, `zh-cn`, `zh-hk`, `zh`.

Response


200 OK

{
  "sid": "1c4fe1fc-88f4-4aec-9df0-bcd069a3628a",
  "account_sid": "467ac6d6-c25a-4b89-848d-0d60619d01e4",
  "date_created": "2024-12-16T00:57:55Z",
  "date_updated": "2024-12-16T00:57:55Z",
  "service_sid": "b0de6fba-6639-40fe-8c06-b6153371aa0a",
  "to": "+85512334667",
  "channel": "sms",
  "status": "pending",
  "url": "http://verify.lvh.me/v2/Services/b0de6fba-6639-40fe-8c06-b6153371aa0a/Verifications/1c4fe1fc-88f4-4aec-9df0-bcd069a3628a",
  "send_code_attempts": [
    {
      "attempt_sid": "ec57a073-1027-471f-8a22-f2953e522a2d",
      "channel": "sms",
      "time": "2024-12-16T00:57:55Z"
    }
  ]
}

02. Start a Verification with Voice

Request

curl -X POST "https://verify.somleng.org/v2/Services/3fbf13e7-d616-4aa4-89d1-7825579a2be4/Verifications" \
    -u 79d3003d-0d9c-433d-8d94-0fd16e378be5:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "To=+85512334667" \
    --data-urlencode "Channel=call"

Endpoint

POST https://verify.somleng.org/v2/Services/:ServiceSid/Verifications

POST https://verify.somleng.org/v2/Services/3fbf13e7-d616-4aa4-89d1-7825579a2be4/Verifications

Parameters

{
  "To": "+85512334667",
  "Channel": "call"
}

Name	Description
ServiceSid	Path Parameter: The SID of the verification Service to create the resource under.
To required	Request Body Parameter: The phone number or email to verify. Phone numbers must be in E.164 format.
Channel required	Request Body Parameter: The verification method to use. One of: `sms` or `call`
Locale	Request Body Parameter: Locale will automatically resolve based on phone number country code of the recipient for SMS and call channel verifications. It will fallback to English if the selected translation is not available. This parameter will override the automatic locale resolution. The following locales are supported: `en`, `de`, `es`, `fr`, `it`, `ja`, `nl`, `pt`, `ar`, `ca`, `da`, `fi`, `id`, `ko`, `pl`, `ru`, `sv`, `tr`, `uk`, `vi`, `af`, `cs`, `el`, `hi`, `hr`, `hu`, `km`, `kn`, `lt`, `mr`, `ms`, `nb`, `pt-br`, `ro`, `sk`, `te`, `th`, `tl`, `zh-cn`, `zh-hk`, `zh`.

Response


200 OK

{
  "sid": "41be99df-b197-473b-ae67-94c405e121d7",
  "account_sid": "79d3003d-0d9c-433d-8d94-0fd16e378be5",
  "date_created": "2024-12-16T00:57:55Z",
  "date_updated": "2024-12-16T00:57:55Z",
  "service_sid": "3fbf13e7-d616-4aa4-89d1-7825579a2be4",
  "to": "+85512334667",
  "channel": "call",
  "status": "pending",
  "url": "http://verify.lvh.me/v2/Services/3fbf13e7-d616-4aa4-89d1-7825579a2be4/Verifications/41be99df-b197-473b-ae67-94c405e121d7",
  "send_code_attempts": [
    {
      "attempt_sid": "048759f1-ddbf-43eb-94b3-326fa2ffa849",
      "channel": "call",
      "time": "2024-12-16T00:57:55Z"
    }
  ]
}

03. Check a Verification with a Phone Number

This API will check whether the user-provided verification code is correct.

⚠️ The verification SID is automatically deleted once it's:

expired (10 minutes)
approved or canceled

If any of these occur, verification checks will return a 404 Not Found error. If you'd like to double check what happened with a given verification - please use the Dashboard Verify Logs.

Request

curl -X POST "https://verify.somleng.org/v2/Services/73e7bcaa-7da4-42d7-b5a6-77a8d5662caf/VerificationCheck" \
    -u 7c6ed0c0-438a-4e52-ba00-9c960385f9f0:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "To=+85512334667" \
    --data-urlencode "Code=1234"

Endpoint

POST https://verify.somleng.org/v2/Services/:ServiceSid/VerificationCheck

POST https://verify.somleng.org/v2/Services/73e7bcaa-7da4-42d7-b5a6-77a8d5662caf/VerificationCheck

Parameters

{
  "To": "+85512334667",
  "Code": "1234"
}

Name	Description
ServiceSid	Path Parameter: The SID of the verification Service to create the resource under.
Code required	Request Body Parameter: The 4-10 character string being verified.
To	Request Body Parameter: The phone number to verify. Either this parameter or the `verification_sid`` must be specified. Phone numbers must be in E.164 format.
VerificationSid	Request Body Parameter: A SID that uniquely identifies the Verification. Either this parameter or the `To` phone number must be specified.

Response


200 OK

{
  "sid": "0ce7231d-9598-4d92-a398-2906ae6c165e",
  "account_sid": "7c6ed0c0-438a-4e52-ba00-9c960385f9f0",
  "date_created": "2024-12-16T00:57:54Z",
  "date_updated": "2024-12-16T00:57:54Z",
  "service_sid": "73e7bcaa-7da4-42d7-b5a6-77a8d5662caf",
  "to": "+85512334667",
  "channel": "sms",
  "status": "approved"
}

04. Check a Verification with a SID

Request

curl -X POST "https://verify.somleng.org/v2/Services/3e24dedc-c4be-4796-bd56-98d4b5a3fe50/VerificationCheck" \
    -u 1cc39a86-089d-4674-b585-264322f068d4:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "VerificationSid=d53db79f-de11-4faf-ae39-59710e50fdd3" \
    --data-urlencode "Code=1234"

Endpoint

POST https://verify.somleng.org/v2/Services/:ServiceSid/VerificationCheck

POST https://verify.somleng.org/v2/Services/3e24dedc-c4be-4796-bd56-98d4b5a3fe50/VerificationCheck

Parameters

{
  "VerificationSid": "d53db79f-de11-4faf-ae39-59710e50fdd3",
  "Code": "1234"
}

Name	Description
ServiceSid	Path Parameter: The SID of the verification Service to create the resource under.
Code required	Request Body Parameter: The 4-10 character string being verified.
To	Request Body Parameter: The phone number to verify. Either this parameter or the `verification_sid`` must be specified. Phone numbers must be in E.164 format.
VerificationSid	Request Body Parameter: A SID that uniquely identifies the Verification. Either this parameter or the `To` phone number must be specified.

Response


200 OK

{
  "sid": "d53db79f-de11-4faf-ae39-59710e50fdd3",
  "account_sid": "1cc39a86-089d-4674-b585-264322f068d4",
  "date_created": "2024-12-16T00:57:54Z",
  "date_updated": "2024-12-16T00:57:54Z",
  "service_sid": "3e24dedc-c4be-4796-bd56-98d4b5a3fe50",
  "to": "+85512334667",
  "channel": "sms",
  "status": "approved"
}

05. Fetch a Verification

Request

curl "https://verify.somleng.org/v2/Services/763f82fa-b00f-4ba0-8c61-2b57b8ac88ca/Verifications/152d25a9-f8d6-4b23-bc91-0b8395330b22" \
    -u ce141f84-5985-4990-8b4c-6b3b38f6627b:AuthToken

Endpoint

GET https://verify.somleng.org/v2/Services/:ServiceSid/Verifications/:Sid

GET https://verify.somleng.org/v2/Services/763f82fa-b00f-4ba0-8c61-2b57b8ac88ca/Verifications/152d25a9-f8d6-4b23-bc91-0b8395330b22

Parameters

Name	Description
ServiceSid	Path Parameter: The SID of the Verification Service to fetch the Verification from.
Sid	Path Parameter: The SID of the Verification.

Response


200 OK

{
  "sid": "152d25a9-f8d6-4b23-bc91-0b8395330b22",
  "account_sid": "ce141f84-5985-4990-8b4c-6b3b38f6627b",
  "date_created": "2024-12-16T00:57:54Z",
  "date_updated": "2024-12-16T00:57:54Z",
  "service_sid": "763f82fa-b00f-4ba0-8c61-2b57b8ac88ca",
  "to": "+85512334667",
  "channel": "sms",
  "status": "pending",
  "url": "http://verify.lvh.me/v2/Services/763f82fa-b00f-4ba0-8c61-2b57b8ac88ca/Verifications/152d25a9-f8d6-4b23-bc91-0b8395330b22",
  "send_code_attempts": []
}

06. Update a Verification Status

Manually mark the verification as approved after your application had validated the verification code or mark the verification as canceled to start a new verification session with a different code before the previous code expires (10 minutes). Only recommended during testing or if you're using custom verification codes.

For most other use cases, Verify is able to manage the complete lifecycle of a verification with the Verification Check Resource.

Request

curl -X POST "https://verify.somleng.org/v2/Services/cb4ce84b-997f-42d3-a369-1189f05704fa/Verifications/3261d5d4-a2ea-4b06-be68-3eb4917e22eb" \
    -u a3598866-64d0-4da8-881c-368deb6519f1:AuthToken \
    -H "Content-Type: application/x-www-form-urlencoded" \
    --data-urlencode "Status=approved"

Endpoint

POST https://verify.somleng.org/v2/Services/:ServiceSid/Verifications/:Sid

POST https://verify.somleng.org/v2/Services/cb4ce84b-997f-42d3-a369-1189f05704fa/Verifications/3261d5d4-a2ea-4b06-be68-3eb4917e22eb

Parameters

{
  "Status": "approved"
}

Name	Description
ServiceSid	Path Parameter: The SID of the Verification Service to update the resource from.
Sid	The SID of the Verification resource to update.
To required	The phone number or email to verify. Phone numbers must be in E.164 format.
Status required	The new status of the resource. Can be: `canceled` or `approved`.

Response


200 OK

{
  "sid": "3261d5d4-a2ea-4b06-be68-3eb4917e22eb",
  "account_sid": "a3598866-64d0-4da8-881c-368deb6519f1",
  "date_created": "2024-12-16T00:57:55Z",
  "date_updated": "2024-12-16T00:57:55Z",
  "service_sid": "cb4ce84b-997f-42d3-a369-1189f05704fa",
  "to": "+85512334667",
  "channel": "sms",
  "status": "approved",
  "url": "http://verify.lvh.me/v2/Services/cb4ce84b-997f-42d3-a369-1189f05704fa/Verifications/3261d5d4-a2ea-4b06-be68-3eb4917e22eb",
  "send_code_attempts": []
}