Innocalls
Web Call

List Web Call Applications

Retrieve list of web call application details

List

Details

DescriptionThe "List" endpoint returns a comprehensive list of web call application details associated with the current organization.
HTTP MethodGET
Endpoint URLhttps://platform.innocalls.com/v1/api-gateway/web-call/list
AuthorizationTo access the API endpoints, you need to authenticate using API keys and API secrets. The API supports Basic Authentication for authorization. You need to include your API ID as the username and your API secret as the password in the HTTP header when making requests. Replace API_ID with your API ID and API_SECRET with your API secret, separated by a colon (:). The value after Basic is the Base64 encoding of your API key and API secret concatenated with a colon.
Rate Limit3 requests per second

Request Example


curl 'https://platform.innocalls.com/api/v1/api-gateway/web-call/list' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic <base64-encoded string  apiId:apiSecret>'

Success Response Example

{
  "data": {
    "apps": [
      {
        "id": "APP_UNIQUE_IDENTIFIER",
        "iconText": "ICON_TEXT_OF_APP",
        "iconBackgroundColor": "ICON_BACKGROUND_COLOR_OF_APP",
        "iconBaseColor": "ICON_BASE_COLOR_OF_APP",
        "iconFontColor": "ICON_FONT_COLOR_OF_APP",
        "destinationNumber": "DESTINATION_NUMBER",
        "concurrentCalls": "CONCURRENT_CALLS_THAT_ALLOWED_OF_APP",
        "serviceEnabled": "APP_SERVICE_ENABLE_OR_NOT",
        "domains": ["ALLOWED_ORIGINS"],
        "callerId": "CALLER_ID_THAT_WILL_APPEAR"
      }
    ]
  }
}

Description

This JSON response signifies a successful retrieval of app details. It contains an array of objects, where each object represents a web call application along with its associated attributes. Here's a breakdown of the key attributes:

  • id: Unique identifier for the application.
  • iconText: Text displayed as the icon for the application.
  • iconBackgroundColor: Background color of the application's icon.
  • iconBaseColor: Base color of the application's icon.
  • iconFontColor: Font color of the application's icon.
  • destinationNumber: The phone number that receives incoming calls.
  • concurrentCalls: Maximum number of concurrent calls allowed for the application.
  • serviceEnabled: Indicates whether the service of the application is enabled or not.
  • domains: List of allowed origins or domains for the application.
  • callerId: The phone number that will appear when the application makes calls.

Possible Errors

Error CodeDescription
401 UnauthorizedInvalid Credential
403 ForbiddenNot Enough Permissions to access the resource
429 Too Many RequestsThis occurs when requests exceed the rate limit

On this page