Method description

readPersons is the method used to read one or more new persons from itslearning

Preconditions for use

You will need to know the syncIDs of the persons you want to read.

Message Schema

Input parameters / request message elements



Data type

Allowed values



Wrapper for a list of <identifier> elements



The syncID of the person to be inserted


Max 64 chars


Please refer to the WSDL for the full element structure, only key elements are described here

Response message elements



Data type


Wrapper containing a list of <person> elements


The Person data to be stored in the new record. Refer to Managing persons for full details on the person object


The <ExtensionField> 'IsExternalUser' will be returned with <fieldValue> 'True' in the response if the user was created externally, i.e. the user is from another site and participating in a community course.

This is in addition to the <Extension> that can be inserted/updated using create/update/replacePerson(s) (CustomString fields, email information, relationship, see description under createPerson').



I want to read person data from persons with

  • syncID = 1234567 -> Does not exist in itslearning

  • syncID = 333222

    from itslearning.

Example request message

<soapenv:Envelope xmlns:soapenv="" xmlns:ims="" xmlns:ims1="" xmlns:ims2="">

Example response message

For each <sourcedIdSet><identifier> in the request you will get a status in the <statusinfoSet><status> in the response. The order of the <statusInfoset><status> corresponds to the the order of the <sourcedIdset><idendifier> in the request.

In the example below, the first <sourcedIdset><identifier> does not exist in itslearning -> <statusinfoSet><status> = failure (1). The second <sourcedIdset><idendifier> exists and data is returned successfully (2).

<s:Envelope xmlns:s="" xmlns:u="">
<h:syncResponseHeaderInfo xmlns:h="" xmlns="" xmlns:xsi="" xmlns:xsd="">
<language xmlns="">en-US</language>
<text xmlns="">The 'sourcedId' identifier is unknown in the target system</text>
<o:Security s:mustUnderstand="1" xmlns:o="">
<u:Timestamp u:Id="_0">
<s:Body xmlns:xsi="" xmlns:xsd="">
<readPersonsResponse xmlns="">
<formatName xsi:nil="true" xmlns=""/>
<name xmlns="">
<namePartValue>The Blonde Bombshell</namePartValue>
<email xmlns="">[email protected]</email>
<URL xmlns=""/>
<userId xmlns="">
<userIdValue xmlns="">marmon</userIdValue>
<address xmlns="">
<demographics xmlns="">
<institutionRole xmlns="">
<tel xmlns="">
<tel xmlns="">