Fetch Collections - Dojah Inc

curl "https://api.dojah.io/api/v1/face/collections" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

const res = await fetch("https://api.dojah.io/api/v1/face/collections", {
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.dojah.io/api/v1/face/collections",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
)
data = res.json()

{
  "entity": {
    "collections": [
      {
        "collection_id": "a1b2c3d4-e5f6-4789-abcd-ef1234567890",
        "app_id": "65379278cb72d65ba457f93b",
        "name": "Sandbox Collection",
        "created_at": "2026-08-27T10:26:44.798Z"
      }
    ]
  }
}

GET/api/v1/face/collections

Return every face collection created for your app, including each collection’s id, name, app_id, and created_at.

Headers

Header	Required	Description
`Authorization`	Yes	Your app’s secret key, sent as-is — not `Bearer`.
`AppId`	Yes	The App ID from your dashboard.

Query parameters

None. The list is scoped to the app tied to the key you call with.

Response

Returns an entity.collections array. Each item has a collection_id, app_id, name, and created_at.

Field	Type	Description
`collections[].collection_id`	string	Unique ID of the collection. Pass this when you enroll, authenticate, or search.
`collections[].app_id`	string	The app this collection belongs to.
`collections[].name`	string	Display name of the collection.
`collections[].created_at`	string	ISO 8601 timestamp of when the collection was created.

Errors

Code	Meaning
`401`	Unauthorized — check your key and `AppId` (no `Bearer` prefix).
`402`	Insufficient wallet balance. Fund your wallet.
`429`	Too many requests — back off and retry.

curl "https://api.dojah.io/api/v1/face/collections" \
  -H "Authorization: {{secret_key}}" \
  -H "AppId: {{app_id}}"

const res = await fetch("https://api.dojah.io/api/v1/face/collections", {
  headers: {
    Authorization: process.env.DOJAH_SECRET_KEY,
    AppId: process.env.DOJAH_APP_ID,
  },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://api.dojah.io/api/v1/face/collections",
    headers={
        "Authorization": os.environ["DOJAH_SECRET_KEY"],
        "AppId": os.environ["DOJAH_APP_ID"],
    },
)
data = res.json()

{
  "entity": {
    "collections": [
      {
        "collection_id": "a1b2c3d4-e5f6-4789-abcd-ef1234567890",
        "app_id": "65379278cb72d65ba457f93b",
        "name": "Sandbox Collection",
        "created_at": "2026-08-27T10:26:44.798Z"
      }
    ]
  }
}