> ## Documentation Index
> Fetch the complete documentation index at: https://docs.frayme.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List paused nodes on a case

> List the workflow nodes currently paused awaiting an external system,
each with an opaque `pendingHandle` and the actions you may invoke on
it. Requires the **`cases:read`** scope.




## OpenAPI

````yaml /api-reference/openapi.yaml get /cases/{caseId}/pending
openapi: 3.1.0
info:
  title: Frayme Case API
  version: 1.0.0
  description: >
    The partner-facing HTTP API for the Frayme fraud-analysis platform. Submit

    **cases** (KYC, KYB, or Transaction), poll their status, act on paused

    workflow nodes, and deliver external callbacks.


    All requests authenticate with a tenant-scoped API key sent in the

    `X-API-Key` header. Each key carries one or more **scopes** — the required

    scope is listed on every operation below.


    | Scope | Grants |

    | --- | --- |

    | `cases:write` | Submit new cases (`POST /cases`) |

    | `cases:read` | Read a case, list paused nodes, list durable actions |

    | `cases:callback` | Deliver an external callback, or invoke a pending /
    durable action |


    Your tenant is derived from the API key — never send `tenantId` in a request

    body; it is ignored. The base URL and your webhook configuration are

    provisioned for you by Frayme.
servers:
  - url: https://core.us.api.frayme.io
    description: Production.
  - url: https://core.us.api.stg.frayme.io
    description: Staging.
security:
  - apiKeyAuth: []
tags:
  - name: Cases
    description: Submit and read cases.
  - name: Pending actions
    description: Act on a workflow node that is paused awaiting an external system.
  - name: Durable actions
    description: Invoke a broker action on a case after it has been decided.
  - name: Callbacks
    description: Deliver the result of an external callback back to a paused node.
paths:
  /cases/{caseId}/pending:
    get:
      tags:
        - Pending actions
      summary: List paused nodes on a case
      description: |
        List the workflow nodes currently paused awaiting an external system,
        each with an opaque `pendingHandle` and the actions you may invoke on
        it. Requires the **`cases:read`** scope.
      operationId: listPendingNodes
      parameters:
        - $ref: '#/components/parameters/CaseId'
      responses:
        '200':
          description: The paused nodes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PendingList'
              example:
                pending:
                  - nodeId: node_sumsub
                    providerId: sumsub
                    pendingHandle: 84147546-1b38-46d9-95ed-537d0dd4945e
                    expiresAt: '2026-05-19T15:32:04Z'
                    availableActions:
                      - id: refresh_sdk_token
                        label: Refresh SDK Token
                        resolvesAwait: false
                      - id: regenerate_link
                        label: Regenerate Verification Link
                        resolvesAwait: false
                      - id: prefill_applicant_info
                        label: Prefill Applicant Info
                        resolvesAwait: false
        '401':
          description: No API key was supplied.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: The API key is missing the `cases:read` scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: An upstream provider was unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    CaseId:
      name: caseId
      in: path
      required: true
      description: The case identifier returned by `POST /cases`.
      schema:
        type: string
  schemas:
    PendingList:
      type: object
      properties:
        pending:
          type: array
          items:
            $ref: '#/components/schemas/PendingNode'
    Error:
      type: object
      properties:
        error:
          type: string
          description: A human-readable error message.
    PendingNode:
      type: object
      properties:
        nodeId:
          type: string
        providerId:
          type: string
        pendingHandle:
          type: string
          description: >-
            Opaque, per-paused-node, stable across retries, tenant-scoped.
            Expires with the node's await window.
        expiresAt:
          type: string
          format: date-time
        availableActions:
          type: array
          items:
            $ref: '#/components/schemas/PendingAction'
    PendingAction:
      type: object
      properties:
        id:
          type: string
        label:
          type: string
        resolvesAwait:
          type: boolean
          description: >-
            `false` for every action available today — all are side effects that
            leave the node paused.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: A tenant-scoped API key provisioned by Frayme.

````