List

API Reference

Vals

List

get/v2/vals

Lists all vals including all public vals and your unlisted and private vals

Query Parameters

limitnumber

Maximum items to return in each paginated response

minimum1

maximum100

cursorstring

optional

Cursor to start the pagination from

formatdate-time

privacyenum

optional

"public" OR "unlisted" OR "private"

This resource's privacy setting. Unlisted resources do not appear on profile pages or elsewhere, but you can link to them.

Hide ParametersShow Parameters

"public"

"unlisted"

"private"

user_idstring

optional

User ID to filter by

formatuuid

Returns

dataarray of idstringauthorobjectcreatedAtstringdescriptionstringimageUrlstringlinksobjectnamestringprivacyenumVal

linksselfstringnextstringprevstringPaginationLinks

Links to use for pagination

HTTPTypeScript

curl https://api.val.town/v2/vals \
    -d '{}'

200 Example

{
  "data": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "author": {
        "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
        "username": "username"
      },
      "createdAt": "2019-12-27T18:11:19.117Z",
      "description": "description",
      "imageUrl": "imageUrl",
      "links": {
        "html": "https://example.com",
        "self": "https://example.com"
      },
      "name": "name",
      "privacy": "public"
    }
  ],
  "links": {
    "self": "https://example.com",
    "next": "https://example.com",
    "prev": "https://example.com"
  }
}