Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Endpoint ID:1006
Method:
Status
colourGreen
titleGET
URL:

/user/dp-key/{dp-key}/children/data/{contract-id}

/user/ext-key/{ext-key}/{ext-type}/children/data/{contract-id}

 

 

dp-key

dialogportal™ master key that uniquely identifies account to enumerate children for

 ext-key

External key that uniquely identifies account to enumerate children for

 ext-typeType of external key
 contract-id

Identifies the type of children to return and the contract fields to return. If omitted, all child types are returned, each type using the default contract fields for that type

Request body:None 
Span
stylewhite-space:pre
Response body:

JSON data with properties corresponding to the fields in the specified contract. The result will always hold the dialogportal™ master key and if the app making the request is configured to use a specific external key, this key is also included in the response.

Code Block
titleExample 1 – Account has one child of type 2 and contract for children specifies first name, last name and gender and /data is part of the request:
{
	"children”: [
		{
			"id": 1234,
			"type": 2,
			"firstName": "John",
			"lastName": "Doe",
			"gender": "Male"
		}
	]
}
Code Block
titleExample 2 – Account has two children of type 2 and /data is not part of the request
{
	"children”: [
		{
			"id": 1234,
			"type": 2
		},
		{
			"id": 5678,
			"type": 2
		}
	]
}
Code Block
titleExample 3 – Account has no children:
{
	"children":[]
}
Status codes:

200

Account found with success
 404Account was not found