List Material Categories | Ply

Returns a paginated list of material categories for the authenticated business. Parent categories include nested subcategories. Deleted subcategories are filtered out of responses.

Requires scope: categories:read

Returns a paginated list of material categories for the authenticated business. Parent categories include nested subcategories. Deleted subcategories are filtered out of responses.

Requires scope: categories:read

API Key authentication via header

Zero-based page index. Defaults to 0.

Items per page. Defaults to 20, maximum 100.

Sort field and direction (e.g., name,asc or updatedAt,desc). Supports Spring Pageable format.

This endpoint returns an object.

Pagination metadata returned on all list endpoints.

1	{
2	"data": [
3	{
4	"id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
5	"name": "Plumbing Supplies",
6	"subCategories": [],
7	"type": "MATERIAL",
8	"parentId": null,
9	"updatedAt": "2026-01-10T07:00:00Z"
10	}
11	],
12	"pagination": {
13	"page": 0,
14	"size": 20,
15	"totalElements": 1,
16	"totalPages": 1
17	}
18	}

1	{
2	"data": [
3	{
4	"id": "f6a7b8c9-d0e1-2345-fabc-456789012345",
5	"name": "Plumbing Supplies",
6	"subCategories": [],
7	"type": "MATERIAL",
8	"parentId": null,
9	"updatedAt": "2026-01-10T07:00:00Z"
10	}
11	],
12	"pagination": {
13	"page": 0,
14	"size": 20,
15	"totalElements": 1,
16	"totalPages": 1
17	}
18	}

$	curl https://api.getply.com/api/v1/categories \
>	-H "API_KEY: <apiKey>"

Authentication

Query parameters

Response

Errors

Authentication

Query parameters

Response

Errors