Get Versions

Retrieve published versions of an action. Drafts are hidden from public clients.

GET /actions/version/{id}

Get Versions

cURL

curl --request GET \
  --url https://api.example.com/actions/version/{id}

200

{
  "data": [
    {
      "id": "urn:via:action:abc-123",
      "actionId": "507f1f77bcf86cd799439011",
      "version": 1,
      "published": true,
      "createdAt": "2025-01-01T00:00:00.000Z",
      "updatedAt": "2025-01-02T00:00:00.000Z",
      "digestSRI": "sha256-abc123...",
      "content": {}
    }
  ],
  "totalPages": 1
}

Headers

API-Version · string

Pin responses to a specific API version (YYYY-MM-DD). When omitted, defaults to the version stored in your issuer config or today's date.

Pattern: ^\d{4}-\d{2}-\d{2}$

Example:

"2026-03-03"

Path Parameters

id · string · required

Query Parameters

pageIndex · number · default: 0

Page number

Example:

0

pageSize · number · default: 10

Number of items per page

Required range: 5 <= x <= 100

Example:

10

search · string

Search query to filter by. Is case-insensitive and does not need to match the entire value.

Maximum string length: 100

Example:

"example"

active · boolean

Filter by active status. Accepts true/false as string or boolean.

Example:

true

Response

200 - application/json

Get versions of an action

data · object[] · required

Show child attributes

totalPages · number · required

Example:

1