import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

const { data: categories } = await client.categories.list({
  name_cont: 'Shirts',
  limit: 25,
})

spree api get /categories -d '{"name_cont":"Shirts","limit":25}'

{
  "data": [
    {
      "id": "ctg_UkLWZg9DAJ",
      "name": "Clothing",
      "permalink": "clothing",
      "position": 0,
      "depth": 0,
      "meta_title": null,
      "meta_description": null,
      "meta_keywords": null,
      "children_count": 0,
      "parent_id": null,
      "description": "",
      "description_html": "",
      "image_url": null,
      "square_image_url": null,
      "is_root": true,
      "is_child": false,
      "is_leaf": true,
      "external_references": {},
      "metadata": {},
      "pretty_name": "Clothing",
      "lft": 1,
      "rgt": 2,
      "products_count": 0,
      "created_at": "2026-01-15T12:00:00.000Z",
      "updated_at": "2026-01-15T12:00:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 25,
    "count": 1,
    "pages": 1,
    "from": 1,
    "to": 1,
    "in": 1,
    "previous": null,
    "next": null
  }
}