You can control the number of nested levels of property information that the REST Web Services server will return when you request property values. Use the atg-rest-depth control parameter to specify the number of levels that will be included in returned data.

The number of nested levels you can expand in returned data is limited by the maxDepthAllowed configuration for the REST Web Services server. See maxDepthAllowed.

The default number of levels is zero which returns only the immediate properties of the Nucleus component you specify in your request. If one of those properties includes multiple values or is a complex object, the returned data will include only the REST path of the property value. For example:

<creditCards>http://myserver:8080/rest/repository/atg/userprofiling/ProfileAdapterRepository/user/130001/creditCards</creditCards>

If you set the return depth to one, the returned data will expand properties that contain multiple values and complex objects. The individual values within them will be included in the returned data. For example:

<creditCards>
  <element>
    <key>MyOtherCard</key>
    <value>
      <atgRestComponentPath>/atg/userprofiling/ProfileAdapterRepository</atgRestComponentPath>
      <atgRestItemDescriptor>credit-card</atgRestItemDescriptor>
      <atgRestRepositoryId>usercc10003</atgRestRepositoryId>
    </value>
  </element>
  <element>
    <key>MyCard</key>
    <value>
      <atgRestComponentPath>/atg/userprofiling/ProfileAdapterRepository</atgRestComponentPath>
      <atgRestItemDescriptor>credit-card</atgRestItemDescriptor>
      <atgRestRepositoryId>usercc10001</atgRestRepositoryId>
    </value>
  </element>
</creditCards>