Skip to main content
GET
List your application's acceptance policy versions

Authorizations

X-API-Key
string
header
required

Query Parameters

limit
integer
default:10

Maximum number of records to return in a single page. Must be between 1 and 1000.

Required range: 1 <= x <= 1000
offset
integer | null

Number of records to skip from the beginning. Use 0 for the first page. Cannot be used with cursor.

Required range: x >= 0
cursor
string | null

Opaque pagination cursor token that identifies the position in the result set. Use the cursor from the previous response to get the next page. Cannot be used with offset.

sort
enum<string> | null

version_number: the order versions were made in; unique within the application, so it is its own tiebreak. Defaults to version_number desc. The field an acceptance policy version list sorts on.

Available options:
version_number
sort_direction
enum<string> | null

asc or desc, for every key of the sort. Defaults to the field's own: version_number desc.

Available options:
asc,
desc

Response

Policy versions in the requested order.

policy_version_id
string<uuid>
required

The version's id.

version_number
integer
required

Its number; version 1 is the default.

Required range: x >= 1
environment
enum<string>
required

The application's environment.

Available options:
sandbox,
production
policy_hash
string
required

sha256: and the hex digest of the policy body the SDK ran.

Pattern: ^sha256:[0-9a-f]{64}$
Example:

"sha256:0000000000000000000000000000000000000000000000000000000000000000"

created_at
string<date-time>
required

When the version was made.

minimum_policy_schema_version
integer
required

The policy feature level an SDK needs to enforce this version; below it the SDK runs it report-only.

Required range: x >= 1
policy
PolicyBody (v1) · object
required

The rules.

warnings
PolicyWarning (v1) · object[]
required

Steps or rules that are allowed but suspect.

created_by
ActedBy (v1) · object | null

Who made it; null for the seeded default.