GetExtension (v2)

Overview

Reads an extension.

The function is available as a Web Service request.

Request

Parameters of the API request:

Parameter	Type	Description	Requirements
token	String	API authentication token	Mandatory
environmentFilter	EnvironmentFilter	Specifies the environment	Mandatory
extension	String	Specifies the extension	Mandatory

Response

Parameters of the API response:

Parameter

Type

Description

return

Status

Possible return values:

- OK
- ERROR_GENERAL
- ERROR_ILLEGAL_ARGUMENT
- ERROR_UNAUTHORIZED

extension

GetExtensionResponse

Extensions

Examples

Example GetExtension transaction.

Example GetExtension transaction.

Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v2="http://v2.provisioning.ws.web.verba.com/">
   <soapenv:Header/>
   <soapenv:Body>
      <v2:getExtension>
         <token>vpAWrB4SIQk7NNuHGvRLV2FM7rjLQjB6</token>
         <environmentFilter>
            <eid>0000</eid>
            <eidExact>0</eidExact>
            <inactive>0</inactive>
            <!-- Needed if eid is not present
            <shortName></shortName>
            <shortNameExact></shortNameExact>
            -->
         </environmentFilter>
         <extension>verbatestuser2@verbalabs.com</extension> <!-- Mandatory! -->
      </v2:getExtension>
   </soapenv:Body>
</soapenv:Envelope>

Response:

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:getExtensionResponse xmlns:ns2="http://v2.provisioning.ws.web.verba.com/">
         <return>
            <extension>
               <eid>0000</eid>
               <environmentShortName>Ref.</environmentShortName>
               <extension>verbatestuser2@verbalabs.com</extension>
               <id>56</id>
               <im>false</im>
               <recordingMode>ON_DEMAND</recordingMode>
               <screenCaptureEnabled>false</screenCaptureEnabled>
               <user>
                  <agentId/>
                  <apiAccessOnly>false</apiAccessOnly>
                  <crmUserId/>
                  <customDateFormat/>
                  <customTimeFormat/>
                  <displayName>strange-emailx</displayName>
                  <eid>0000</eid>
                  <email>louise.o'donnell@verbalabs.com</email>
                  <environmentShortName>Ref.</environmentShortName>
                  <externalId/>
                  <id>4</id>
                  <language>en</language>
                  <locked>false</locked>
                  <loginName>strange-email</loginName>
                  <needChangePassword>false</needChangePassword>
                  <nonModifiable>false</nonModifiable>
                  <passwordExpires>false</passwordExpires>
                  <passwordHash>.....................</passwordHash>
                  <timeZone>Europe/Budapest</timeZone>
                  <userType>user_type_verba</userType>
                  <validFrom>2015-09-03T11:56:00Z</validFrom>
                  <validTo>2099-12-31T00:00:00Z</validTo>
               </user>
               <video>false</video>
               <voice>true</voice>
            </extension>
            <status>
               <statusCode>OK</statusCode>
            </status>
         </return>
      </ns2:getExtensionResponse>
   </S:Body>
</S:Envelope>