API referenceAd Account Requests

List ad account changes

Lists the changes asked for on the organization's ad accounts, newest first: optionally only those of one request (requestId, its id or its KST-… reference) or in one status. Each carries what was asked (label), its status, and the reason it was refused. A key limited to specific brands is refused with 403 brand_not_allowed: requests belong to the whole organization.

GET
/v1/ad-account-requests/changes
bearerAuth
headerAuthorizationBearer <token>

An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.

requestId?string

Only the changes of this request: its id, or its Koast reference (KST-…).

Length1 <= length <= 40
status?string

Only the changes in this status.

Value in"open""info_requested""done""refused""cancelled"

Response Body

List ad account changes

application/json
  1. response
changes*array<>

Newest first.

curl -X GET "https://example.com/v1/ad-account-requests/changes" \  -H "Authorization: Bearer koast_sk_..."
{  "changes": [    {      "id": "string",      "requestId": "string",      "adAccountId": "string",      "kind": "rename",      "status": "open",      "label": "string",      "reason": "string",      "askedAt": "string",      "decidedAt": "string",      "acknowledged": true,      "cardLast4": "string"    }  ]}

Required scope: read. CLI: koast list-ad-account-changes, see Ad Account Requests commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.