View a list

Fetch a specific list without its items.

GET https://api.jsonpad.io/lists/{listId}

Example

cURL
123curl https://api.jsonpad.io/lists/5241cf96-baea-4e83-ae7c-4f7d6ed548c8 \
  -H "Content-Type: application/json" \
  -H "x-api-token: <YOUR TOKEN>"

Parameters

  • required
    listIdstringA list id or path name.

Request headers

  • required
    x-api-tokenstringYour API token.
  • optional
    if-modified-since

    An ISO 8601 date.

    If the list hasn't been updated since this date, we return an empty 304 ("Not modified") response, and the request will not be counted towards any active rate limits.

Request body

No request body

Response body

200 OK
{
id: "271e9cec-d236-4ddb-95b0-a1ed51181f3f"
createdAt: "2026-09-05T11:29:42.114Z"
updatedAt: "2026-09-05T11:29:42.114Z"
user: {
id: "914af871-859e-410b-8637-2151fe89b18c"
createdAt: "2026-09-05T11:29:42.114Z"
updatedAt: "2026-09-05T11:29:42.114Z"
lastActiveAt: "2026-09-05T11:29:42.114Z"
activated: true
displayName: "Sample User"
description: "Sample user description"
}
name: "Sample List"
pathName: "sample-list"
description: "Sample list description"
schema: null
pinned: false
readonly: false
realtime: false
protected: false
indexable: true
activated: true
itemCount: 0
}

Response headers

  • last-modified2026-09-05T11:29:42.114ZThe date this list was last modified.
2024-10-29