Applications

You can use the API to manage features of applications in your project.

Get Numbers

Get information about your numbers. It returns a list of numbers that you own, as well as their capability (voice or SMS). For the ones that are assigned to an app, it returns the application key of the app.

SecurityBasic or Signed
Responses
200

A success response, or an Error.

Response Schema: application/json
Array of objects

The object type. Will always be list of numbers, associated application keys and capabilities

Array
number
string

Numbers that you own in E.164 format.

applicationkey
string

Indicates the application where the number(s) will be assigned. If no number is assigned the applicationkey will not be returned.

capability
string (capability)

Valid values are voice and sms

Enum Value Description
voice

Able to make Voice calls.

sms

Able to send SMS messages.

get/v1/configuration/numbers
Request samples 
Response samples 
application/json
{
  • "numbers": [
    • {
      },
    • {
      },
    • {
      }
    ]
}
Update Numbers
Assign a number or a list of numbers to an application.


SecurityBasic or Signed 
Request 
Request Body schema: application/json
numbers
Array of strings  [ 1 .. 100 ] items 
The phone number or list of numbers in E.164 format.


 
applicationkey
string
indicates the application where the number(s) will be assigned. If empty, the application key that is used to sign the request will be used.


 
capability
string
indicates the DID capability that needs to be assigned to the chosen application. Please note that the DID needs to support the selected capability.


 Enum Value Description
voice
Able to make Voice calls.


sms
Able to send SMS messages.


 
Responses 
204
A success response, or an Error.


post/v1/configuration/numbers
Request samples 
application/json
{
  • "numbers": [
    • "+14151112223333"
    ],
  • "applicationkey": "11983f76-12c8-1111-9515-4785c7b67ca8",
  • "capability": "voice"
}
Un-assign number
Un-assign a number from an application.


SecurityBasic or Signed 
Request 
Request Body schema: application/json
number
string
 
applicationkey
string
Indicates the application where the number(s) was assigned. If empty, the application key that is used to sign the request will be used.


 
capability
string
(optional) indicates the DID capability that was assigned to the chosen application. Please note that the DID needs to support the selected capability.


 Enum Value Description
voice
Able to make Voice calls.


sms
Able to send SMS messages.


 
Responses 
204
A success response, or an Error.


delete/v1/configuration/numbers
Request samples 
application/json
{
  • "numbers": "+14151112223333",
  • "applicationkey": "11983f76-12c8-1111-9515-4785c7b67ca8",
  • "capability": "voice"
}
Get Callback URLs
Returns any callback URLs configured for the specified application.


SecurityBasic or Signed 
Request 
path Parameters
applicationkey
required
string
The unique identifying key of the application.


 
 Example:  94983f76-1161-6655-9515-4785c7b67dd8
Responses 
200
A success response, or an Error.


Response Schema: application/json
object
Contains primary and or fallback callback URLs


 
primary
string
Your primary callback URL


 
fallback
string
Your fallback callback URL (returned if configured). It is used only if Sinch platform gets a timeout or error from your primary callback URL.


 
get/v1/configuration/callbacks/applications/{applicationkey}
Request samples 
Response samples 
application/json
{}
Update Callbacks
Update the configured callback URLs for the specified application.


SecurityBasic or Signed 
Request 
path Parameters
applicationkey
required
string
The unique identifying key of the application.


 
 Example:  94983f76-1161-6655-9515-4785c7b67dd8
Request Body schema: application/json
object
Contains primary and or fallback callback URLs


 
primary
string
Your primary callback URL


 
fallback
string
Your fallback callback URL (returned if configured). It is used only if Sinch platform gets a timeout or error from your primary callback URL.


 
Responses 
204
A success response, or an Error.


post/v1/configuration/callbacks/applications/{applicationkey}
Request samples 
application/json
{}
Query numberDeprecated
Returns information about the requested number.


SecurityBasic or Signed 
Request 
path Parameters
number
required
string
The phone number you want to query.


 
 Example:  +46730170101
Responses 
200
A success response, or an Error.


Response Schema: application/json
object
The number item object.


 
countryId
string
The ISO 3166-1 formatted country code.


 
numberType
string
The type of the number.


 Enum Value Description
Unknown
Unknown number type.


Fixed
A fixed number.


Mobile
A mobile number.


Other
A type other than fixed or mobile.


 
normalizedNumber
string
The number in E.164 format.


 
restricted
boolean
Concerns whether the call is restricted or not.


 
object (price) 
 
get/v1/calling/query/number/{number}
Request samples 
Response samples 
application/json
{
  • "method": "numberItem",
  • "numberItem": {
    • "countryId": "SE",
    • "numberType": "Mobile",
    • "normalizedNumber": "+14151112223333",
    • "restricted": false,
    • "rate": {
      }
    }
}
SecurityPrivacyLegal & ComplianceCookie Statement
© 2025 Sinch. All rights reserved.