Create a list

Creates an empty list for saving parcels and places.

Parameters

No parameters.

Request body

namerequiredstring: The list's name, up to 200 characters.

Responses

201: list object; The saved list.
401: ProblemDetail; credential_missing, credential_invalid or credential_expired. The request has no valid credential.
403: ProblemDetail; scope_missing, person_required, api_key_not_accepted or entitlement_missing. The credential or plan does not allow this request. detail names the reason.
422: ProblemDetail; parameter_invalid, id_malformed or a cursor code. A parameter is missing or invalid. errors lists each one.
429: ProblemDetail; rate_limited. Too many requests. Retry after the Retry-After interval. Nothing is charged.

Example request

curl -X POST 'https://api.placestack.com/v1/list' \
  -H "Authorization: Bearer $PLACESTACK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "string"
}'

Example response

{
  "object": "list",
  "id": "lst_01h455vb4pex5vsknk084sn02q",
  "name": "Sites under review",
  "item_count": 12,
  "created_at": "2026-09-13T12:00:00Z",
  "updated_at": "2026-09-13T12:00:00Z",
  "href": "/v1/list/lst_01h455vb4pex5vsknk084sn02q"
}

Parameters

Request body

Responses

Next steps

GET /list/{list_id}