Page Comparison

Excerpt

Searches the entire dialogportal™ database for accounts that matches a given search string.

Endpoint ID:

1011

Method:

Status

colour	Green
title	POST

URL:

/user/search/{contract-id}

contract-id

Identifies the type of entities to search for and the contract fields to return. If omitted, all entity types are searched, each type returned using the default contract fields for that type.

Request body:

JSON data with search settings

Required fields
	searchFor	The string to search for in the database
Optional fields
	offset	The offset in search results from where to return data. If omitted, offset is set to zero
	limit	The maximum number of entities to return. It is not possible to return more than 50 entities per request, and if omitted, limit is set to 50

Code Block

title	Example 1 – Search for “John Doe”:

{
	"searchFor": "John Doe"
}

Code Block

title	Example 2 – Search for “John Doe” with an offset of 40 and return no more than 20 entities:

{
	"searchFor": "John Doe",
	"offset": 40,
	"limit": 20
}

Span

style	white-space:pre

Response body:

JSON data with an array of the found entities. The result will also contain an object with properties that specify number of entities returned, the offset and whether there are more entities than the ones returned.

Code Block

title	Example 1 – Search for “John Doe” with a limit of one:

{
	"entities": [
		{
			"dpKey": 12345,
			"name": "John Doe"
		}
	],
	"paging": {
		"offset": 0,
		"count": 1,
		"more": true
	}
}

Code Block

title	Example 2 – Search for “Doe” without limit:

{
	"entities": [
		{
			"dpKey": 12345,
			"name": "John Doe"
		},
		{
			"dpKey": 67890,
			"name": "Johnny Doe"
		}
	],
	"paging": {
		"offset": 0,
		"count": 2,
		"more": false
	}
}

Status codes:

200

One or more entities were found

404

No entities were found

Versions Compared

Old Version 4

New Version 5

Key