Items

List items

get/v1/data/{workspace_id}/collections/{collection_id}/items?count=10

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

List the items in your collection. See the Item object for the response fields.

These examples use a Person collection with firstName and lastName properties. Use your collection's itemsType and property keys.

To paginate:

GET https://api.datablist.com/v1/data/:workspace_id/collections/:collection_id/items?count=10&start_after_document_id=XX

info

Without count, the API returns all items. To request pages, set count and pass the last returned item's ID as start_after_document_id for the next page.

To return only matching items, use the JSON filter query parameter. See Filtering for supported operators and example calls, and Ordering for sorting and pagination rules. When filtering with count or start_after_document_id, explicitly order by one of the filtered fields.

Request

import requests

url = "https://api.datablist.com/v1/data/workspace_example/collections/collection_example/items?count=10"

headers = {
    "Accept": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

Response · illustrative example

{
  "@context": {
    "@vocab": "http://vocab.datablist.com/",
    "@import": "http://vocab.datablist.com/terms.jsonld"
  },
  "data": [
    {
      "@id": "item_example",
      "createdAt": "2021-01-08T10:24:26.612030+00:00",
      "updatedAt": "2021-02-15T15:48:18.007428+00:00",
      "@type": "Person",
      "firstName": "John",
      "lastName": "Malkovich"
    },
    {
      "@id": "item_other",
      "createdAt": "2021-01-08T10:24:26.612030+00:00",
      "updatedAt": "2021-02-15T15:48:18.007428+00:00",
      "@type": "Person",
      "firstName": "John",
      "lastName": "Malkovich"
    }
  ]
}