Find Object Folders | Amniscient Documentation

import requests
url = "https://api.amniscient.com/folder/detection-item"
querystring = {"organization_id":"organization_id","page":"1","limit":"10"}
headers = {"x-api-key": "x-api-key"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

{
  "data": [
    {
      "detection_item_collection_map": {
        "collected": 0,
        "uncollected": 0
      },
      "id": "c977ce0b-e710-402a-9c88-f1496e3ec626",
      "name": "New Objects",
      "organization_id": "0fa18537-d3d0-4a5c-a82c-b80bb6a7b1b8",
      "created_at": "2026-01-22T17:18:24.876Z",
      "updated_at": "2026-01-22T17:19:44.359Z",
      "created_by": "API"
    }
  ],
  "total": 3,
  "limit": 10,
  "page": 1
}

Find existing object folders within your organization's library.

Query parameters

organization_idstringRequiredformat: "uuid"

Your organization's unique identifier.

searchstringOptional

A search term to filter your object folder results by folder name.

pagedoubleOptional

The starting page of the response results. By default, response results will begin on page 1.

limitdoubleOptional

The number of results per page in the response. By default, pages will have 10 results per page.

Response

200 - Folders retrieved successfully

datalist of objects

An array of folders returned based on your query. If a folder was not found, this array will be empty.

totalinteger

The total number of folders found based on your query.

limitinteger

The number of results per page in the response. By default, pages will have 10 results per page.

pageinteger

The starting page of the response results.

Errors

400

Bad Request Error

401

Unauthorized Error

Headers

Query parameters

Response

Errors