PgBeam Docs
Approvals

List approval requests

GET
/v1/projects/{project_id}/approvals

Lists approval requests for the project, newest first, optionally filtered by status.

Authorization

AuthorizationBearer <token>

JWT issued by Better Auth. Verified via JWKS.

In: header

Path Parameters

project_id*string

Unique project identifier (prefixed, e.g. prj_xxx).

Query Parameters

status?string

Filter to a single status.

page_size?integer

Maximum number of items to return (1-100, default 20).

page_token?string

Opaque token for cursor-based pagination.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/projects/string/approvals"
{  "approvals": [    {      "id": "apr_01h455vb4pex5vsknk084sn02q",      "project_id": "string",      "credential_id": "string",      "policy_profile_id": "string",      "region": "string",      "session_id": "string",      "sql": "string",      "normalized_sql": "string",      "statement_kind": "string",      "status": "pending",      "reason": "string",      "requested_at": "2019-08-24T14:15:22Z",      "decided_at": "2019-08-24T14:15:22Z",      "decided_by": "string",      "expires_at": "2019-08-24T14:15:22Z"    }  ],  "next_page_token": "string"}
{  "error": {    "code": "string",    "message": "string"  }}
{  "error": {    "code": "string",    "message": "string"  }}
{  "error": {    "code": "string",    "message": "string"  }}
{  "error": {    "code": "string",    "message": "string"  }}
{  "error": {    "code": "string",    "message": "string"  }}