/v1/communities/{community_id}/lists/{list_id}AuthGet one list by id.
Path parameters
community_id*stringSocial community UUID.
list_id*stringList UUID.
Query parameters
actor_idstring · uuidViewer actor UUID — required to see a private list (must equal owner).
Response · 200 List.
id*string · uuidList UUID.
Example: "11111111-0000-0000-0000-000000000001"
community_id*string · uuidOwning community UUID.
Example: "cccccccc-cccc-cccc-cccc-cccccccccccc"
owner_id*string · uuidList owner — social actor UUID.
Example: "aaaaaaaa-0000-0000-0000-000000000001"
name*stringList display name.
Example: "Tech news"
description*stringOptional description.
Example: "Curated tech accounts I follow."
visibility*objectpublic = discoverable; private = owner-only.
Example: "public"
member_count*numberCurrent member count.
Example: 12
created_at*string · date-timeISO timestamp.
Example: "2026-05-01T12:00:00.000Z"
updated_at*string · date-timeISO timestamp.
Example: "2026-05-01T12:00:00.000Z"
Example
Request
GET https://social.productcraft.co/v1/communities/{community_id}/lists/{list_id}
Authorization: Bearer YOUR_TOKENResponse
{
"id": "11111111-0000-0000-0000-000000000001",
"community_id": "cccccccc-cccc-cccc-cccc-cccccccccccc",
"owner_id": "aaaaaaaa-0000-0000-0000-000000000001",
"name": "Tech news",
"description": "Curated tech accounts I follow.",
"visibility": "public",
"member_count": 12,
"created_at": "2026-05-01T12:00:00.000Z",
"updated_at": "2026-05-01T12:00:00.000Z"
}