×

Get specific users under application using pagination.

GET

https:/<sub_domain>/v2/integrations/usermapping

  • Replace <subdomain> with the region of your account
    1. <subdomain> of Singapore cluster is @api.exotel.com

You can use our official postman collection to try out the APIs.

 

The following are the parameters:

Header:

Parameter

Type

Required

Description

Authorization

String

Yes

Token provided by https://integrationscore.mum1.exotel.com/v2/integrations/token

entity=app

 

Query params:

Parameter

Type

Required

Description

last_value

integer

Optional

It required for next page value, gather from previous page.

Default value: 0

page_size

integer

Optional

Default size 20.

 

  • Request Example
curl --location -g --request GET 'https://integrationscore.us3.qaexotel.com/v2/integrations/usermapping?last_value={{optional}}&page_size={{optional}}' \
--header 'Authorization: {{AuthCode}}'
  • Response Example
{
    "RequestId": "875cf137-90f9-4ed2-93ef-6be226d0af85",
    "Status": "Success",
    "Code": 200,
    "Error": "",
    "Data": {
        "Users": [
                {
            "CustomerId": "99fa98a1-2ce0-457c-9371-0d3a01eb6ef0",
            "AppID": "2e6440ed-ff62-49d7-bb00-5494b313a863",
            "AppUserId": "1",
            "ExotelAccountSid": "abc",
            "ExotelUserId": "fasdfdsf",
            "AppUsername": "Temp Name",
            "ExotelUserName": "Temp Name",
            "AgentNumber": "+0000000000",
            "ActiveDeviceId": "",
            "PhoneDeviceID": "057",
            "SipDeviceID": "9012",
            "VirtualNumber": "01135124165",
            "Email": "temp.user@company.in",
            "OutboundActive": false,
            "Role": "admin",
            "SipId": "sip:a4343j",
            "SipSecret": "b*5#TGC$2!r&s#X2H1Rt",
            "IsActive": true,
            "UserDetail": null,
            "CreatedAt": "0001-01-01T00:00:00Z",
            "UpdatedAt": "0001-01-01T00:00:00Z"
        },
        {
                ....
        },
               ....
        ],
        "PageSize": 20,
        "LastEvaluatedValue": "21"
    }
}

Status Codes

 

Status codes are as follows - 

Status Code

Description

200

App users get successfully.

401

Unauthorized. Check the entity id and secret.

400

Invalid parameters.

500

Internal server error. There was an issue getting users.