# client.policies.versions

> client.policies.versions — the policies.versions operations.

`client.policies.versions` — the `policies.versions` operations.

On `AsyncKindgi` every method is the same, awaited.

## `client.policies.versions.list()`

```python signature
list(
    policy_id: str | UUID,
    /,
    *,
    limit: int | None = None,
    cursor: str | None = None,
    include_tombstoned: bool | None = None,
    timeout: float | None = None,
) -> PolicyVersionCollectionPage
```

List versions of a policy. `GET /v1/policies/{policyId}/versions`

Cursor-paginated list of policy versions. Defaults to active-only. Pass `?includeTombstoned=true` to include soft-tombstoned rows too; tombstoned rows carry `unregisteredAt` (ISO string), active rows do not.

## `client.policies.versions.get()`

```python signature
get(
    policy_id: str | UUID,
    version: str,
    /,
    *,
    timeout: float | None = None,
) -> PolicyVersionRow
```

Fetch a specific policy version. `GET /v1/policies/{policyId}/versions/{version}`

An unregistered version is returned too, with `unregisteredAt`.

## `client.policies.versions.unregister()`

```python signature
unregister(
    policy_id: str | UUID,
    version: str,
    /,
    *,
    idempotency_key: str | None = None,
    timeout: float | None = None,
) -> UnregisterPolicyResult
```

Unregister a policy version. `POST /v1/policies/{policyId}/versions/{version}/unregister`