List Collections
curl --request GET \
--url https://{instance}.domo.com/api/datastores/v1/collections \
--header 'X-DOMO-Developer-Token: <api-key>'import requests
url = "https://{instance}.domo.com/api/datastores/v1/collections"
headers = {"X-DOMO-Developer-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-DOMO-Developer-Token': '<api-key>'}};
fetch('https://{instance}.domo.com/api/datastores/v1/collections', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{instance}.domo.com/api/datastores/v1/collections",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-DOMO-Developer-Token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{instance}.domo.com/api/datastores/v1/collections"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-DOMO-Developer-Token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{instance}.domo.com/api/datastores/v1/collections")
.header("X-DOMO-Developer-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{instance}.domo.com/api/datastores/v1/collections")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-DOMO-Developer-Token"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": "cf97ef6f-4c7c-4739-9af5-5cc0bd782ddb",
"datastoreId": "78a89993-3d3a-4b57-a325-1b3886fe1e1b",
"defaultPermissions": "READ,CREATE_CONTENT,READ_CONTENT,UPDATE_CONTENT,DELETE_CONTENT",
"requiredAuthorities": null,
"owner": 870010733,
"name": "groups",
"datasourceId": null,
"schema": null,
"filters": null,
"syncEnabled": false,
"syncRequired": false,
"fullReplaceRequired": false,
"lastSync": null,
"createdOn": "2026-06-24T20:09:12.502Z",
"updatedOn": "2026-06-24T20:09:12.502Z",
"updatedBy": 870010733
},
{
"id": "8050a95f-7865-4ed9-bbeb-a82eaf1d1c41",
"datastoreId": "f812ea02-0e52-478b-90f0-00aad7e05029",
"defaultPermissions": null,
"requiredAuthorities": null,
"owner": 870010733,
"name": "users",
"datasourceId": "de683ed7-eb83-4799-a9c7-876da6b5b008",
"schema": {
"columns": [
{
"type": "STRING",
"name": "username"
},
{
"type": "DATETIME",
"name": "joined"
}
]
},
"filters": null,
"syncEnabled": true,
"syncRequired": false,
"fullReplaceRequired": false,
"lastSync": "2026-06-24T21:42:28Z",
"createdOn": "2026-06-24T21:35:39.593Z",
"updatedOn": "2026-06-24T21:42:28.493Z",
"updatedBy": 870010733
}
]List Collections
Get all collections visible to the current user. Use datastoreId to filter by datastore.
GET
/
api
/
datastores
/
v1
/
collections
List Collections
curl --request GET \
--url https://{instance}.domo.com/api/datastores/v1/collections \
--header 'X-DOMO-Developer-Token: <api-key>'import requests
url = "https://{instance}.domo.com/api/datastores/v1/collections"
headers = {"X-DOMO-Developer-Token": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-DOMO-Developer-Token': '<api-key>'}};
fetch('https://{instance}.domo.com/api/datastores/v1/collections', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://{instance}.domo.com/api/datastores/v1/collections",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-DOMO-Developer-Token: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://{instance}.domo.com/api/datastores/v1/collections"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-DOMO-Developer-Token", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://{instance}.domo.com/api/datastores/v1/collections")
.header("X-DOMO-Developer-Token", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://{instance}.domo.com/api/datastores/v1/collections")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-DOMO-Developer-Token"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": "cf97ef6f-4c7c-4739-9af5-5cc0bd782ddb",
"datastoreId": "78a89993-3d3a-4b57-a325-1b3886fe1e1b",
"defaultPermissions": "READ,CREATE_CONTENT,READ_CONTENT,UPDATE_CONTENT,DELETE_CONTENT",
"requiredAuthorities": null,
"owner": 870010733,
"name": "groups",
"datasourceId": null,
"schema": null,
"filters": null,
"syncEnabled": false,
"syncRequired": false,
"fullReplaceRequired": false,
"lastSync": null,
"createdOn": "2026-06-24T20:09:12.502Z",
"updatedOn": "2026-06-24T20:09:12.502Z",
"updatedBy": 870010733
},
{
"id": "8050a95f-7865-4ed9-bbeb-a82eaf1d1c41",
"datastoreId": "f812ea02-0e52-478b-90f0-00aad7e05029",
"defaultPermissions": null,
"requiredAuthorities": null,
"owner": 870010733,
"name": "users",
"datasourceId": "de683ed7-eb83-4799-a9c7-876da6b5b008",
"schema": {
"columns": [
{
"type": "STRING",
"name": "username"
},
{
"type": "DATETIME",
"name": "joined"
}
]
},
"filters": null,
"syncEnabled": true,
"syncRequired": false,
"fullReplaceRequired": false,
"lastSync": "2026-06-24T21:42:28Z",
"createdOn": "2026-06-24T21:35:39.593Z",
"updatedOn": "2026-06-24T21:42:28.493Z",
"updatedBy": 870010733
}
]Authorizations
Domo Developer Token for authentication.
Query Parameters
Filter collections by datastore ID.
When true, returns only collections the current user can share.
Response
200 - application/json
OK
Unique identifier for the collection.
ID of the datastore this collection belongs to.
Comma-separated default permission set for new app grants on this collection, or null if not set.
Maps CollectionOperation names to required authority strings, or null if not set.
User ID of the collection owner.
Name of the collection.
ID of the linked Domo DataSet, or null if not yet linked.
Show child attributes
Show child attributes
Array of document-level filter predicates applied to read operations, or null if not set.
Whether documents are periodically synced to the linked DataSet.
Whether a sync is pending.