Find Object Folders

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 or null

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

totalinteger or null

The total number of folders found based on your query.

limitinteger or null

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

pageinteger or null

The starting page of the response results.

Headers

Query parameters

Response

Errors