# List pending approvals

> The calls kept for the user's approval in the customer panel - waiting ones and recent ones.

- Effect: Read - Changes nothing.
- Idempotent: yes
- Stability: stable
- MCP tool: `manitu_approval_list` on https://mcp.manitu.de/mcp
- REST: `POST https://api.manitu.de/v1/approval/list`
- Page: /reference/approval/list/

## MCP tool

`manitu_approval_list`

### Description for the model

Lists the calls of this access in the manitu customer account that wait for the user's approval in the customer panel, and those of the last 7 days, newest first - each with its status, what it is about (approval.elements) and until when it waits. A call answered with approval_required and a pending_action is one of them. Nothing here approves anything: only the user does, signed in to the customer panel. Use it to tell the user what waits, or to find a pending_action_id again.

### Arguments

- `status_list` (array of any) - Only these statuses, e.g. ["pending"]; left out: all. (uniqueItems `true`)
- `scope` (string) - own (default): this access's; account: those of every access of the account - for the main access, any other gets its own. (one of `"own"`, `"account"`)
- `page_size` (integer) - How many entries per page, default 100. (minimum `1`; maximum `500`)
- `page_token` (string) - next_page_token of the previous page - with the same filters. (pattern `"^[^\\x00-\\x1F\\x7F]*$"`)

### Example

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "manitu_approval_list",
    "arguments": {}
  }
}
```

## REST

`POST https://api.manitu.de/v1/approval/list`

### Description

Lists the calls of the calling access that wait for approval in the customer panel, and those of the last 7 days, newest first - each with its status, what it is about (approval.elements) and until when it waits. A call answered with approval_required is one of them. It approves nothing: only the user does, signed in to the customer panel. One of them: [`POST /v1/approval/get`](/reference/approval/get.md). Changes nothing.

### Authentication

One of `X-API-Key`, `Authorization: Bearer …` - never more than one in a request.

### Request body

JSON; unknown fields are refused.

- `status_list` (array of any) - Only these statuses, e.g. ["pending"]; left out: all. (uniqueItems `true`)
- `scope` (string) - own (default): this access's; account: those of every access of the account - for the main access, any other gets its own. (one of `"own"`, `"account"`)
- `page_size` (integer) - How many entries per page, default 100. (minimum `1`; maximum `500`)
- `page_token` (string) - next_page_token of the previous page - with the same filters. (pattern `"^[^\\x00-\\x1F\\x7F]*$"`)

### Response

In `data`; the rest of the body as on every call.

- `pending_action_list` (array of object, required)
  - `pending_action_list[].pending_action_id` (string, required) - The id, not guessable, bound to the account and the access that made it. (minLength `1`; maxLength `255`)
  - `pending_action_list[].status` (any, required) - pending: waits for the person; approved: approved, not carried out yet; executed: carried out, result is its answer; failed: carried out, it failed - result says how; unverified: carried out, whether it took effect is not known; declined: the person said no; expired: nobody decided in time; cancelled: the caller withdrew it. (one of `"pending"`, `"approved"`, `"executed"`, `"failed"`, `"unverified"`, `"declined"`, `"expired"`, `"cancelled"`)
  - `pending_action_list[].operation_id` (string | null) - The operation of the route export it carries out; null where the backend does not say. (pattern `"^[a-z][a-z0-9]*(_[a-z][a-z0-9]*)*$"`)
  - `pending_action_list[].created_at` (string, required) - (format `date-time`)
  - `pending_action_list[].expires_at` (string, required) - Until when it waits for the person. (format `date-time`)
  - `pending_action_list[].decided_at` (string | null) - When it was approved, declined, cancelled or expired; null while it is pending. (format `date-time`)
  - `pending_action_list[].decided_via` (string | null) - Where it was decided: panel - the backend's own user interface; api - a call of the backend (cancelled); an open set, lower_snake_case. null while it is pending. (pattern `"^[a-z][a-z0-9]*(_[a-z0-9]+)*$"`)
  - `pending_action_list[].approval` (object) - The approval it waits for - the ways while it is pending, none once it is decided. Not under approval_required, where it stands beside it as params.approval.
    - `pending_action_list[].approval.required_level` (any, required) - The level of approval the call needs (components/1/approval-levels.json). A reader compares ranks, never names. (one of `"none"`, `"client_dialog"`, `"caller_confirmation"`, `"client_click"`, `"signed_in_person"`, `"fresh_second_factor"`)
    - `pending_action_list[].approval.concerns` (array of any, required) - What the approval is about, at least one, each once: terms (a declaration on terms), price (it costs money), contract (a contract is concluded, changed or ended), irreversible (what is deleted or overwritten cannot be brought back), downtime (a service is unreachable for a while), service_access (someone gets access to a service or its data), account_access (who can access the account changes), ownership (something leaves the account or changes its owner), disclosure (data goes to a party outside the account). A closed set; a new value comes with a new release of the spec. An approval given in advance never covers terms or price. (minItems `1`; uniqueItems `true`)
    - `pending_action_list[].approval.raised_by` (array of any, required) - Why the level is above what the operation needs at least, where it is: consumer_price (it costs a consumer money), outside_content (this credential read content from the internet shortly before), account_rule (the account has it so), input_content (what the call sets runs code or sends data out of the account), input_field (the call sends a field the operation asks more for, approval_by_field of the route export). Empty where the level is the operation's own. A closed set; a new value comes with a new release of the spec. (uniqueItems `true`)
    - `pending_action_list[].approval.elements` (array of object, required) - What the approval is about, each shown as it is - may be empty.
      - `pending_action_list[].approval.elements[].kind` (any, required) - document, text, declaration - what the person agrees to; subject, change, consequence - what is done and what follows; price - what it costs. (one of `"document"`, `"text"`, `"price"`, `"declaration"`, `"subject"`, `"change"`, `"consequence"`)
      - `pending_action_list[].approval.elements[].code` (string | null) - What it is, as a code - required by a reader for document, text and declaration, which are logged by it. (pattern `"^[a-z][a-z0-9]*(_[a-z0-9]+)*$"`)
      - `pending_action_list[].approval.elements[].title` (string | null) - Its title, in language.
      - `pending_action_list[].approval.elements[].language` (string | null) - The language of title and text - the binding wording. (pattern `"^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$"`)
      - `pending_action_list[].approval.elements[].url` (string | null) - Where the document is; a document only.
      - `pending_action_list[].approval.elements[].text` (string | null) - The text, shown as it is: of a text, a declaration (a sentence in the first person) or a consequence.
      - `pending_action_list[].approval.elements[].label` (string | null) - Of a subject or a change: what it is about (Server, Package).
      - `pending_action_list[].approval.elements[].value` (string | null) - Of a subject: which one (vs-1002).
      - `pending_action_list[].approval.elements[].before` (string | null) - Of a change: the value now.
      - `pending_action_list[].approval.elements[].after` (string | null) - Of a change: the value after.
      - `pending_action_list[].approval.elements[].price` (object) - Of a price: what it costs.
        - `pending_action_list[].approval.elements[].price.charges` (array of object, required) - The charges, at least one - e.g. a prorated amount now and the new plan per year. (minItems `1`)
          - `pending_action_list[].approval.elements[].price.charges[].code` (string, required) - What the charge is for, a lower_snake_case code of the backend, e.g. domain_fee, plan_fee - the reader translates it. (pattern `"^[a-z0-9]+(_[a-z0-9]+)*$"`)
          - `pending_action_list[].approval.elements[].price.charges[].billing` (object, required) - How the charge is billed.
            - `pending_action_list[].approval.elements[].price.charges[].billing.kind` (string, required) - one_time: charged once; recurring: charged per period; usage: charged by use, per unit, settled per period. An open set: a reader that does not know a kind shows the price by its summary. (pattern `"^[a-z0-9]+(_[a-z0-9]+)*$"`)
            - `pending_action_list[].approval.elements[].price.charges[].billing.period` (object) - The billing period - with recurring and usage, not with one_time.
              - `pending_action_list[].approval.elements[].price.charges[].billing.period.unit` (string, required) - hour, day, month, year, or the unit a usage charge counts in - an open set of lower_snake_case codes. A reader that does not know one shows the price by its summary. (pattern `"^[a-z0-9]+(_[a-z0-9]+)*$"`)
              - `pending_action_list[].approval.elements[].price.charges[].billing.period.length` (integer, required) - How many of the unit, at least 1. (minimum `1`)
            - `pending_action_list[].approval.elements[].price.charges[].billing.per` (object) - The unit a usage charge counts, e.g. 1 hour - with usage, and only there.
              - `pending_action_list[].approval.elements[].price.charges[].billing.per.unit` (string, required) - hour, day, month, year, or the unit a usage charge counts in - an open set of lower_snake_case codes. A reader that does not know one shows the price by its summary. (pattern `"^[a-z0-9]+(_[a-z0-9]+)*$"`)
              - `pending_action_list[].approval.elements[].price.charges[].billing.per.length` (integer, required) - How many of the unit, at least 1. (minimum `1`)
          - `pending_action_list[].approval.elements[].price.charges[].usage` (object) - What bounds a usage charge - with usage only.
            - `pending_action_list[].approval.elements[].price.charges[].usage.cap` (any) - The most the charge comes to per billing period - binding, with the digits of the currency.
            - `pending_action_list[].approval.elements[].price.charges[].usage.included` (object) - How much of the unit is in the price before the rate applies - in the unit of billing.per.
              - `pending_action_list[].approval.elements[].price.charges[].usage.included.unit` (string, required) - hour, day, month, year, or the unit a usage charge counts in - an open set of lower_snake_case codes. A reader that does not know one shows the price by its summary. (pattern `"^[a-z0-9]+(_[a-z0-9]+)*$"`)
              - `pending_action_list[].approval.elements[].price.charges[].usage.included.length` (integer, required) - How many of the unit, at least 1. (minimum `1`)
          - `pending_action_list[].approval.elements[].price.charges[].condition` (string) - When the charge is due at all, a lower_snake_case code: on_success - only when what it is for succeeds. An open set; not there: always. (pattern `"^[a-z0-9]+(_[a-z0-9]+)*$"`)
          - `pending_action_list[].approval.elements[].price.charges[].service_period` (object) - The days the charge covers, the first and the last both included - e.g. the rest of a period on a change of plan.
            - `pending_action_list[].approval.elements[].price.charges[].service_period.from` (string, required) - The first day. (format `date`)
            - `pending_action_list[].approval.elements[].price.charges[].service_period.to` (string, required) - The last day. (format `date`)
          - `pending_action_list[].approval.elements[].price.charges[].phases` (array of object, required) - What the charge amounts to, phase by phase, in order: each begins where the one before it ends. A one_time charge has one phase, without cycles; the last phase of a recurring or usage charge has cycles null, and only that one. (minItems `1`)
            - `pending_action_list[].approval.elements[].price.charges[].phases[].kind` (string, required) - trial, promo or regular. An open set: a reader that does not know a kind shows the price by its summary. (pattern `"^[a-z0-9]+(_[a-z0-9]+)*$"`)
            - `pending_action_list[].approval.elements[].price.charges[].phases[].cycles` (integer | null) - How many billing periods the phase lasts; null: without end. Not there with one_time. (minimum `1`)
            - `pending_action_list[].approval.elements[].price.charges[].phases[].period` (object) - The billing period of this phase, where it differs from billing.period - e.g. three months free of a yearly plan.
              - `pending_action_list[].approval.elements[].price.charges[].phases[].period.unit` (string, required) - hour, day, month, year, or the unit a usage charge counts in - an open set of lower_snake_case codes. A reader that does not know one shows the price by its summary. (pattern `"^[a-z0-9]+(_[a-z0-9]+)*$"`)
              - `pending_action_list[].approval.elements[].price.charges[].phases[].period.length` (integer, required) - How many of the unit, at least 1. (minimum `1`)
            - `pending_action_list[].approval.elements[].price.charges[].phases[].amount` (any, required) - What is charged per period of the phase - never per month unless the period is one. With usage: per unit of billing.per, and it may have more digits than the currency.
        - `pending_action_list[].approval.elements[].price.summary` (string) - The whole price in one sentence, in the language of the answer, as the backend writes it - what a reader shows where it does not know a code. Never instead of the charges. (minLength `1`; maxLength `1000`)
    - `pending_action_list[].approval.ways` (array of object, required) - How it can be given, the best first; the last is the fallback. A reader takes the first it can use and passes over a kind it does not know. Empty once a kept call is decided.
      - `pending_action_list[].approval.ways[].kind` (string, required) - call_again - the caller sends the same call again with token in the input field parameter, after an explicit yes of the person; panel - a person approves it in the backend's own user interface, at url. An open set, lower_snake_case. (pattern `"^[a-z][a-z0-9]*(_[a-z0-9]+)*$"`)
      - `pending_action_list[].approval.ways[].token` (string) - Of call_again: what to send with the same call again - bound to this call and its input. (minLength `1`; maxLength `255`)
      - `pending_action_list[].approval.ways[].parameter` (string) - Of call_again: the input field the token goes in - a protocol parameter of the operation, approval_token. (pattern `"^[a-z][a-z0-9]*(_[a-z0-9]+)*$"`)
      - `pending_action_list[].approval.ways[].url` (string) - Of panel: the page where the person approves it. A pointer only - the person signs in there all the same. (minLength `1`)
    - `pending_action_list[].approval.expires_at` (string | null, required) - Until when the approval can be given; null where the backend does not say. (format `date-time`)
  - `pending_action_list[].result` (object | null) - The structured answer of the operation it carried out, once executed, failed or unverified; null until then.
  - `pending_action_list[].created_by` (object, required) - Who made it - for the main access, which sees the calls of every access of the account.
    - `pending_action_list[].created_by.account_user_id` (integer, required) - The access that made it.
    - `pending_action_list[].created_by.type` (string, required) - primary: the main access; secondary: a sub access. (one of `"primary"`, `"secondary"`, `"ngcobalt_site_mail_user"`)
    - `pending_action_list[].created_by.description` (string | null, required) - The description written for it, null if nothing - not its name or user name.
- `total_count` (integer, required) - How many entries match, on all pages together.
- `next_page_token` (string | null, required) - Pass as page_token for the next page; null on the last. (pattern `"^[^\\x00-\\x1F\\x7F]*$"`)

### Statuses

- `200` Success.
- `400` The input is wrong, or the request itself (INVALID_INPUT). Each entry names its field and its reason - correct the input and call again.
- `401` No credential was presented, or it was not recognised (UNAUTHENTICATED).
- `403` The credential is valid, but may not do this (PERMISSION_DENIED). The reason says why - another credential is the way, not a repeat.
- `429` Too many calls. The Retry-After header says when to try again.
- `500` The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.
- `503` The channel this operation forwards through is unavailable.

### Example

```sh
curl -X POST \
  'https://api.manitu.de/v1/approval/list' \
  -H "X-API-Key: $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{}'
```

## Example result

```json
{
  "pending_action_list": [
    {
      "pending_action_id": "string",
      "status": "pending",
      "operation_id": "string",
      "created_at": "2026-10-23T12:00:00+02:00",
      "expires_at": "2026-10-23T12:00:00+02:00",
      "decided_at": "2026-10-23T12:00:00+02:00",
      "decided_via": "string",
      "approval": {
        "required_level": "none",
        "concerns": [
          "terms"
        ],
        "raised_by": [
          "consumer_price"
        ],
        "elements": [
          {
            "kind": "document",
            "code": "string",
            "title": "string",
            "language": "string",
            "url": "https://www.example.com/",
            "text": "string",
            "label": "string",
            "value": "string",
            "before": "string",
            "after": "string",
            "price": {
              "charges": [
                {
                  "code": null,
                  "billing": null,
                  "usage": null,
                  "condition": null,
                  "service_period": null,
                  "phases": null
                }
              ],
              "summary": "string"
            }
          }
        ],
        "ways": [
          {
            "kind": "string",
            "token": "eyJwYWdlIjoyfQ",
            "parameter": "string",
            "url": "https://www.example.com/"
          }
        ],
        "expires_at": "2026-10-23T12:00:00+02:00"
      },
      "result": {},
      "created_by": {
        "account_user_id": 12345,
        "type": "primary",
        "description": "Example"
      }
    }
  ],
  "total_count": 1,
  "next_page_token": "eyJwYWdlIjoyfQ"
}
```
