---
search:
  tags:
    - Mutations
    - GET
seo:
  description: >-
    Lists your organization's Mutations, newest first. Reference for the GET
    /mutations endpoint in the AdCrunch API.
sidebar:
  label: List mutations
  badge: GET
title: List mutations
type: openapi-operation
---
Lists your organization's Mutations, newest first.

One page at a time: `limit` rows at most, 100 by default. When the answer holds `nextCursor`, more rows exist: send it back as `cursor` to get the next page. When it is absent, you have the last page. The cursor is opaque: send it back with no change, and do not build one.

A row that is still `running` is checked against the change itself as the page is read, so a Mutation that finished after its row was written shows its true outcome here.

`status=awaiting_confirmation` lists only the changes that wait for a person to confirm them in the console. Only a change that an AI agent started through MCP waits. A cursor of the whole history does not work on this list, and the reverse.

This is the history read, and it needs `mutation:read`. Starting a Mutation and polling the one you started need `mutation:write`.

`GET /mutations`

**Responses**

- `200` — One page of Mutations, newest first. This one is the last page, so it carries no \`nextCursor\`.
- `400` — The request does not match the schema of this operation: a field is missing or has the wrong type, or the body is not valid JSON. \`error\` is \`invalid\_request\`, and \`issues\` names each field. Nothing was changed. Or AdCrunch cannot use the \`cursor\`: it cannot read it, or the cursor belongs to a different query. Then \`error\` is \`invalid\_cursor\`. Send the \`nextCursor\` of the previous page with no change, or omit \`cursor\` to get the first page.
- `401` — No API key, or one that does not resolve. See the security scheme. \`error\` is \`unauthorized\`.
- `402` — The organization has no active subscription. An owner subscribes at \`paywallUrl\`. \`error\` is \`organization\_unentitled\`.
- `403` — The caller does not hold \`mutation:read\`. \`error\` is \`forbidden\`.

Response example, 200:

```json
{
  "data": [
    {
      "action": {
        "dailyBudget": 50,
        "kind": "meta_create_campaign",
        "name": "Spring sale prospecting",
        "objective": "OUTCOME_SALES",
        "specialAdCategories": []
      },
      "advertiserId": "acc_1203456789012345",
      "completedAt": null,
      "confirmedAt": null,
      "confirmedBy": null,
      "createdAt": 1790000060000,
      "mutationId": "mut_k3x9q2v7m4n8p1r5t6w0y2z4",
      "organizationId": "org_3a7f10",
      "priorValue": null,
      "provider": "meta",
      "result": null,
      "status": "running",
      "tool": "meta_create_campaign",
      "userId": "usr_4e8b23"
    },
    {
      "action": {
        "id": "120210000000000",
        "kind": "meta_update_status",
        "level": "campaign",
        "status": "PAUSED"
      },
      "advertiserId": "acc_1203456789012345",
      "completedAt": 1790000004000,
      "confirmedAt": null,
      "confirmedBy": null,
      "createdAt": 1790000000000,
      "mutationId": "b3d1f0c4-6a2e-4a1f-9f77-2c0d1e5a8b94",
      "organizationId": "org_3a7f10",
      "priorValue": {
        "status": "ACTIVE"
      },
      "provider": "meta",
      "result": {
        "ok": true,
        "result": {
          "success": true
        }
      },
      "status": "complete",
      "tool": "meta_update_status",
      "userId": "usr_4e8b23"
    }
  ]
}
```
