Get user by username

The GET /users/by/username/{username} endpoint returns the user matching the username provided.

In this page


Most URLs in the example code use the following values:

Headers

Header parameters in Requests (User Admin API) apply to this endpoint.

Authorization scopes supported:

ScopeAccess granted
users:readEntire endpoint
users:writeEntire endpoint

Parameters

The endpoint accepts the following path parameter:

username

Type

Required

Example

StringTruewallboard

User's username.

Requests

Get single user by username

curl -L -X GET "https://***.api.newvoicemedia.com/useradmin/users/by/username/testusername@test.com" \
-H "Accept: application/vnd.newvoicemedia.v4+json" \
-H "Authorization: Bearer <ACCESS_TOKEN>"

Responses

Responses contain the requested user object.

Successful response

Successful requests return a 200 Success code and the requested user.

Example response

{
  "userId": "e439bc44-f867-4779-a3f5-0802e3e7f816",
  "username": "wallboard",
  "name": "Wallboard",
  "email": "wallboard@vonage.com",
  "userId": "8e22b1fe-d2ea-403d-8c03-50eb21188e79",
  "lastLoginTime": "2021-08-26T07:37:55.465Z",
  "active": true,
  "locked": false,
  "ssoExternalId": "exampleSso",
  "userAccountConfiguration": {
    "role": "Wallboard",
    "chargeable": true,
    "actAsAgent": true,
    "agentConfiguration": {
      "agentDisplayId": "123",
      "webrtc": true,
      "agentControlWebrtc": true,
      "handleMultipleInteractions": true,
      "enforcedDispositionCodes": false,
      "transcribeCalls": true,
      "screenRecording": false,
      "callParking": true,
      "salesCadence": false,
      "outboundAutoanswer": true,
      "inboundAutoanswer": true,
      "outboundWrapUp": 100,
      "backToReadyAfterNoAnswer": 100,
      "backToReadyAfterLineBusy": 90,
      "backToReadyAfterInvalidNumber": 80,
      "backToReadyAfterNetworkIssue": 5,
      "callRatingFrequency": 56,
      "video": true,
      "transcribeCallsRealTime": true,
      "callRecordingControls": true,
      "location": "GB",
      "telephonyAddress": {
        "telephoneAddress": "800100",
        "telephonyExtension": "44",
        "outboundTelephonyRegion": "ab6fd03e-de5a-41fb-9ad8-0e9fcb39f827",
        "nationalDisplay": true,
        "virtualLocation": "PL",
		"preventAutoCallbackNumber" : true,
		"selectedCallbackNumberId": "4c0b6793-a4c9-4075-839e-08fb99ba7efd"   
    },
      "capacity": {
        "isAgentLevel": false,
        "live": 60,
        "nonlive": 15,
        "semilive": 75
      },
      "associatedUsers": [
        {
          "username": "supervisor_vbc",
          "applicationType": "VBC"
        }
      ]
    }
  }
}

where:

  • usernameA username for the user. The username is unique in the account.
  • nameThe user’s name, used for display purposes throughout the Vonage Contact Center (VCC) platform.
  • emailThe user’s email address.
  • userIdThe unique ID of the user.
  • lastLoginTimeDate and time of user’s last login to any Vonage Contact Center account.
  • active. A Boolean indicating if the user account is active, false indicates archived users.
  • ssoExternalIdThe value that the user uses to log in to Vonage Contact Center using single sign-on.
  • locked. A Boolean indicating if the user account has been locked out due to failed logins.
  • userAccountConfiguration. Contains user settings. 
    • roleThe user’s role, indicating the tasks that they can perform. Possible values are Admin, Supervisor, Wallboard, or Agent.
    • chargableIndicates if you are charged for this user, Vonage employee users appear as false. Possible values are true or false.
    • actAsAgentIndicates whether this user has agent capabilities. Possible values are true or false.
    • agentConfiguration. Appears if actAsAgent is true. Contains the settings for any agent or user who can act as an agent.
      • agentDisplayIdThe agent’s unique ID.
      • webrtcIndicates whether this agent can use ContactPad with WebRTC. Possible values are true or false.
      • agentControlWebrtcIndicates whether this agent can control ContactPad when using WebRTC. Possible values are true or false.

      • handleMultipleInteractionsIndicates whether this agent can handle more than one interaction. Possible values are true or false.

      • enforcedDispositionCodesIndicates whether this agent must provide a disposition code for an interaction. Possible values are true or false.
      • transcribeCalls. Indicates whether this agent’s calls should be transcribed. Possible values are true or false.
      • screenRecordingIndicates whether this agent’s screen should be recorded during calls. Possible values are true or false.
      • callParkingIndicates whether call parking is turned on for this agent. Possible values are true or false.
      • salesCadenceIndicates whether Cadence is turned on for this agent. Possible values are true or false.
      • outboundAutoanswerIndicates whether this agent’s outbound calls should be automatically answered. Possible values are true or false.
      • inboundAutoanswerIndicates whether this agent’s inbound calls should be automatically answered. Possible values are true or false.
      • outboundWrapUpThe maximum time, in seconds, that the agent can remain in a Wrap Up (Auto) state after an outbound call ends. Maximum value is 7200, minimum value is 1.
      • backToReadyAfterNoAnswerThe maximum time, in seconds, that the agent can remain in an unexpected state if they do not answer their phone (No Answer state appears in ContactPad). Maximum value is 7200, minimum value is 1.
      • backToReadyAfterLineBusyThe maximum time, in seconds, that the agent can remain in an unexpected state if their line is busy (Line Busy state appears in ContactPad). Maximum value is 7200, minimum value is 1.
      • backToReadyAfterInvalidNumberThe maximum time, in seconds, that the agent can remain in a fault state if they have an invalid number in their settings (Network Congestion state appears in ContactPad). Maximum value is 7200, minimum value is 1.
      • backToReadyAfterNetworkIssueThe maximum time, in seconds, that the agent can remain in a fault state due to a network issue (Fault on Line state appears in ContactPad). Maximum value is 7200, minimum value is 1.
      • callRatingFrequencyThe percentage of the agent’s calls that they must rate if the Post Call Quality Rating feature is turned on. If 100, the agent must rate all calls. Maximum value is 100, minimum value is 0.
      • videoIndicates whether agent can use VBC video calling. Possible values are true or false.

      • transcribeCallsRealTime. Indicates whether agent can use the real-time transcription feature. Possible values are true or false.

      • callRecordingControls. Indicates whether agent can control call recordings using ContactPad. Possible values are true or false.

      • locationThe country code for the agent’s physical location used primarily for routing. For example, GB.
      • telephonyAddress
        • telephoneAddressThe agent’s phone number in national format. Vonage Contact Center routes calls to this number. Maximum length is 255. Can contain any of the following characters: \+?[0-9]+.
        • telephonyExtension
        • outboundTelephonyRegion. The telephony region in which the agent is located. Vonage Contact Center uses an agent’s telephony region to determine the telephony server to use when the agent makes an outbound call.
        • nationalDisplay. Whether telephone numbers that the agent sees in the Vonage Contact Center platform are displayed in national format. Possible values are true or false.
        • virtualLocationThe country code for the agent’s virtual location. For example, PL.
        • preventAutoCallbackNumber. Indicates whether the agent is allowed to override the automatically presented callback number. Possible values are true or false.
        • selectedCallbackNumberId. The callback number's unique ID.

      • capacity
        • isAgentLevelIndicates whether this agent’s capacity settings override the account settings. Possible values are true or false.
        • liveThe percentage of this agent’s capacity that is used by a live interaction, such as a phone call. For example, 75. Maximum value is 100, minimum is 51.
        • nonliveThe percentage of this agent’s capacity that is used by a non-live interaction, such as an email. For example, 25. Maximum value is 100, minimum is 1.
        • semiliveThe percentage of this agent’s capacity that is used by a semi-live interaction, such as a chat. For example, 33. Maximum value is 100, minimum is 1.
      • associatedUsersThe non-VCC users that this agent is linked to. 
        • usernameThe username of a non-VCC user that this agent is linked to. For example, supervisor_vbc.
        • applicationTypeThe application that the non-VCC user that is linked to this agent is from. For example, VBC.


Try it out

  

For information, see Trying out Vonage Contact Center APIs.