Retrieve entities using a parameter-based query string

Request

Lists entities that match the query using a parameter-based query string, for example, /api/entities/query?query=Definition.Name=='M.Asset'.

Security

OAuth2.0

Query

querystringrequired

The query string, for example, Definition.Name == 'M.Asset'.

skipinteger, (int32)

Number of items to skip, for example, 0.

takeinteger, (int32)

Number of items to retrieve. maximum is 100, for example, 25.

membersstring

Comma-separated list of members to retrieve, for example, Title,Filename.

renditionsstring

Comma-separated list of renditions to retrieve, for example, Preview,Thumbnail.

cultureobject

Culture for the results, for example, en-US.

sortstring

Sort field, for example, created_on.

orderstring

Sort order, for example, desc.

sortCulturestring

Culture for sorting, for example, en-US.

permissionsToLoadstring

Comma-separated list of permissions to load, for example, Read,Write.

curl -i -X GET \
  'https://your-server/api/entities/query?query=string&skip=0&take=0&members=string&renditions=string&culture=&sort=string&order=string&sortCulture=string&permissionsToLoad=string' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Successful operation

Bodyapplication/json

last_hit_dataArray of strings or null

The last returned hits, which are used to fetch the next page of results.

itemsArray of objects or null(EntityResource)

Gets or sets the list of items.

total_itemsinteger or null, (int64)

Gets or sets the total number of items.

returned_itemsinteger or null, (int64)

Gets or sets the number of returned items.

offsetinteger or null, (int32)

Gets or sets the offset of the items.

nextobject(Link)

Represents a link to a resource.

previousobject(Link)

Represents a link to a resource.

identifierstring or null

Gets or sets the identifier of the resource.

selfobject(Link)

Represents a link to a resource.

property name*anyadditional property

Response

{
  "last_hit_data": [
    "string"
  ],
  "items": [
    { … }
  ],
  "total_items": 0,
  "returned_items": 0,
  "offset": 0,
  "next": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "previous": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "identifier": "string",
  "self": {
    "href": "string",
    "filename_properties": [ … ],
    "title": "string",
    "templated": false
  },
  "property1": null,
  "property2": null
}