Skip to content

List published versions, ordered by number

GET
/v1/plans/{plan_key}/versions
curl --request GET \
--url 'https://api.seal0.app/v1/plans/example/versions?limit=50' \
--header 'Authorization: Bearer <token>'
plan_key
required
string
limit
integer
default: 50 >= 1 <= 200
cursor
string

Opaque cursor from a previous page’s next_cursor.

One page of versions, without values.

Media typeapplication/json
object
data
required
Array<object>
object
created_at
required
string format: date-time
id
required
string
plan_key
required

Feature or plan key.

string
/^[a-z][a-z0-9_]{0,63}$/
published_at
required
string format: date-time
nullable
status
required
string
version
required

Null while draft.

integer
nullable
next_cursor
required
string
nullable

Example generated

{
"data": [
{
"created_at": "2026-04-15T12:00:00Z",
"id": "example",
"plan_key": "example",
"published_at": "2026-04-15T12:00:00Z",
"status": "example",
"version": 1
}
],
"next_cursor": "example"
}

Error envelope.

Media typeapplication/json
object
error
required
object
code
required

Stable snake_case error code.

string
field
required

Offending input field, when known.

string
nullable
message
required
string
request_id
required
string

Example generated

{
"error": {
"code": "example",
"field": "example",
"message": "example",
"request_id": "example"
}
}

Error envelope.

Media typeapplication/json
object
error
required
object
code
required

Stable snake_case error code.

string
field
required

Offending input field, when known.

string
nullable
message
required
string
request_id
required
string

Example generated

{
"error": {
"code": "example",
"field": "example",
"message": "example",
"request_id": "example"
}
}

Error envelope.

Media typeapplication/json
object
error
required
object
code
required

Stable snake_case error code.

string
field
required

Offending input field, when known.

string
nullable
message
required
string
request_id
required
string

Example generated

{
"error": {
"code": "example",
"field": "example",
"message": "example",
"request_id": "example"
}
}

Error envelope.

Media typeapplication/json
object
error
required
object
code
required

Stable snake_case error code.

string
field
required

Offending input field, when known.

string
nullable
message
required
string
request_id
required
string

Example generated

{
"error": {
"code": "example",
"field": "example",
"message": "example",
"request_id": "example"
}
}

Error envelope.

Media typeapplication/json
object
error
required
object
code
required

Stable snake_case error code.

string
field
required

Offending input field, when known.

string
nullable
message
required
string
request_id
required
string

Example generated

{
"error": {
"code": "example",
"field": "example",
"message": "example",
"request_id": "example"
}
}