Get Pick List | Ply | API Documentation

Returns a single pick list by ID.

Requires scope: pick_lists:read

API_KEYstring

API Key authentication via header

idUUIDRequired

Pick list ID.

This endpoint returns an object.

idUUID

Unique identifier for the pick list.

namestring

Display name of the pick list.

statusenum

Current status of the pick list.

fromLocationobject

Source location materials are picked from.

toLocationobject

Destination location materials are transferred to.

materialCountlong

Number of distinct material line items in this pick list.

kitCountlong

Number of kit line items in this pick list.

createdAtdatetime

ISO 8601 timestamp when the record was created.

updatedAtdatetime

ISO 8601 timestamp when the record was last updated.

notestring

Optional note or description for this pick list.

requestDatedate

Requested date for the pick (ISO 8601 date, e.g. 2026-03-25).

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

1	{
2	"id": "c5d6e7f8-a9b0-1234-cdef-567890123456",
3	"name": "Job #1204 - Phase 2 Materials",
4	"status": "DRAFT",
5	"fromLocation": {
6	"id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
7	"name": "Main Warehouse",
8	"type": "WAREHOUSE"
9	},
10	"toLocation": {
11	"id": "d4e5f6a7-b8c9-0123-defa-456789012345",
12	"name": "Job #1204 Site",
13	"type": "JOB"
14	},
15	"materialCount": 3,
16	"kitCount": 0,
17	"createdAt": "2026-03-20T09:00:00Z",
18	"updatedAt": "2026-03-20T09:00:00Z",
19	"note": "Needed for rough-in phase",
20	"requestDate": "2026-03-25"
21	}

$	curl https://api.getply.com/api/v1/pick-lists/c5d6e7f8-a9b0-1234-cdef-567890123456 \
>	-H "API_KEY: <apiKey>"