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

# Check Perp Process

> Poll the status of a long-running perpetual action (typically a deposit) started by /2/perp/execute-v2.

Some actions submitted to `/2/perp/execute-v2` are asynchronous — the most common case is `deposit` on Lighter, which must observe the underlying bridge/settlement before the user's margin is usable. When the execute-v2 response includes a `processId`, poll this endpoint until the process reports a terminal status.

### Query Parameters

<ParamField query="processId" type="string" required>
  UUID returned by `/2/perp/execute-v2` in `data.processId`.
</ParamField>

### Response

<Note>
  **Unwrapped body.** Unlike every other perp route (`{ data: { ... } }`), this endpoint returns the fields below at the top level — there is no `data` envelope. Parse defensively if your client assumes the wrapped shape.

  ```json theme={null}
  {
    "processId": "0c1f6f24-…",
    "status": "settled",
    "message": "deposit settled on L2"
  }
  ```
</Note>

<ResponseField name="processId" type="string">UUID of the tracked process.</ResponseField>

<ResponseField name="status" type="string">
  Process status reported by the execution engine (e.g., `pending`, `settled`, `failed`). Terminal values depend on the action; clients should treat any non-`pending` value as final.
</ResponseField>

<ResponseField name="message" type="string">Human-readable status message.</ResponseField>
<ResponseField name="errorMessage" type="string">Error detail, present only when the process failed.</ResponseField>

### Errors

| Status | `message`                                                                                                     |
| ------ | ------------------------------------------------------------------------------------------------------------- |
| 404    | `Process not found or tracking disabled` — unknown `processId`, or the instance has process tracking disabled |


## OpenAPI

````yaml GET /2/perp/check-process
openapi: 3.0.0
info:
  version: 1.0.0
  title: Mobula API
  description: >-
    Documentation of the Mobula API


    **Demo API**: The default server (demo-api.mobula.io) is a demo API with
    rate limits.

    For production use, please use api.mobula.io with an API key from
    https://admin.mobula.io
servers:
  - url: https://demo-api.mobula.io/api/
    description: Demo API (rate limited, for testing only)
  - url: https://api.mobula.io/api/
    description: Production API (requires API key)
security: []
tags:
  - name: V2 - Token
    description: Token details, price, security, ATH, and holder data
  - name: V2 - Market Data
    description: Market details, OHLCV history, and lighthouse metrics
  - name: V2 - Trades
    description: Token trades, enriched trades, and trade filters
  - name: V2 - Wallet
    description: Wallet positions, activity, trades, analysis, and labels
  - name: V2 - Assets
    description: Cross-chain asset details and price history
  - name: V2 - Swap
    description: Swap quoting and execution
  - name: V2 - Perps
    description: Perpetual futures quoting, execution, and positions
  - name: V2 - Bridge
    description: Cross-chain bridge quoting and intent status (Alpha Preview)
  - name: V2 - DeFi
    description: Bonding pools and pulse data
  - name: V2 - Search
    description: Universal fast search
  - name: V2 - Usage
    description: Per-key API and WebSocket usage history
  - name: V2 - Blockchains
    description: System metadata and chain listings
  - name: V2 - Prediction Markets
    description: >-
      Polymarket markets/events, wallet positions, and the full execution stack
      (auth, order build/submit/cancel, approvals, pUSD wrap/unwrap, deploy,
      deposit/withdraw, redeem). Alpha — see /api/2/pm/*.
  - name: V1 - Market Data
    description: Market prices, history, sparklines, pairs, and multi-data
  - name: V1 - Wallet
    description: Wallet portfolio, transactions, history, and NFTs
  - name: V1 - Token
    description: First buyers
  - name: V1 - Trades
    description: Market trades by pair
  - name: V1 - Metadata
    description: Token metadata, categories, and news
  - name: V1 - Assets
    description: List all assets
  - name: V1 - Search
    description: Search for assets, tokens, and pairs
  - name: V1 - DeFi
    description: Bonding pool pulse data
  - name: V1 - Blockchains
    description: Blockchain listings, pairs, and stats
  - name: V1 - Webhooks
    description: Webhook management
  - name: V1 - Feed
    description: Custom feed creation
paths:
  /2/perp/check-process:
    get:
      tags:
        - V2 - Perps
      summary: Check perp process status
      description: >-
        Poll the status of a long-running perpetual action (typically a deposit)
        started by /2/perp/execute-v2.
      parameters:
        - schema:
            type: string
            description: UUID returned by /2/perp/execute-v2 in data.processId.
          required: true
          description: UUID returned by /2/perp/execute-v2 in data.processId.
          name: processId
          in: query
      responses:
        '200':
          description: Process status
          content:
            application/json:
              schema:
                type: object
                properties:
                  processId:
                    type: string
                  status:
                    type: string
                  message:
                    type: string
                  errorMessage:
                    type: string
                required:
                  - processId
                  - status
        '404':
          description: Process not found or tracking disabled

````