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

# Get intent status

> Poll the current status of an intent. Use this to wait for approval decisions or on-chain confirmation.



## OpenAPI

````yaml /openapi.json get /api/intents/{intentId}/status
openapi: 3.1.0
info:
  title: Mandate API
  version: 1.2.0
  description: >-
    Non-custodial agent wallet policy layer. Enforces spend limits, allowlists,
    and approval workflows for AI agent transactions without ever receiving
    private keys.
  contact:
    name: Mandate
    url: https://mandate.md
    email: support@mandate.md
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
servers:
  - url: https://app.mandate.md
    description: Production
security: []
tags:
  - name: Registration
    description: >-
      Agent registration and claiming. No auth required for register; Sanctum
      auth for claim.
  - name: Agent API
    description: >-
      Endpoints authenticated with a runtime key (Bearer mndt_live_... or
      mndt_test_...). Used by agents to validate transactions, post events, and
      poll status.
  - name: Intent Lifecycle
    description: >-
      Post transaction hashes after broadcast and poll intent status until
      confirmed.
  - name: Dashboard
    description: >-
      Dashboard endpoints for human operators. Authenticated via Sanctum
      (cookie-based session).
  - name: Policies
    description: >-
      Policy management for agents. List, create, and view policy
      configurations.
  - name: Approvals
    description: Approval queue for transactions that require human review.
paths:
  /api/intents/{intentId}/status:
    get:
      tags:
        - Intent Lifecycle
      summary: Get intent status
      description: >-
        Poll the current status of an intent. Use this to wait for approval
        decisions or on-chain confirmation.
      operationId: getIntentStatus
      parameters:
        - name: intentId
          in: path
          required: true
          description: The intent ID returned from validation.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Intent status.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IntentStatus'
              example:
                intentId: 9e5f1a2b-3c4d-5e6f-7a8b-9c0d1e2f3a4b
                status: confirmed
                txHash: >-
                  0x9f2e4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f
                blockNumber: '12345678'
                gasUsed: '65000'
                amountUsd: '50.00'
                decodedAction: transfer(0x71c7...976f, 50000000)
                summary: Transferred 50 USDC to 0x71c7...976f
                blockReason: null
                requiresApproval: false
                approvalId: null
                expiresAt: null
        '401':
          description: Invalid or missing runtime key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Intent not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error: Intent not found.
      security:
        - RuntimeKeyAuth: []
components:
  schemas:
    IntentStatus:
      type: object
      required:
        - intentId
        - status
      properties:
        intentId:
          type: string
          format: uuid
        status:
          type: string
          enum:
            - allowed
            - reserved
            - approval_pending
            - approved
            - rejected
            - broadcasted
            - confirmed
            - failed
            - expired
          description: Current intent state.
        txHash:
          type:
            - string
            - 'null'
          description: On-chain transaction hash, if broadcasted.
        blockNumber:
          type:
            - string
            - 'null'
          description: Block number where the transaction was confirmed.
        gasUsed:
          type:
            - string
            - 'null'
          description: Gas consumed by the transaction.
        amountUsd:
          type:
            - string
            - 'null'
          description: USD value of the transaction.
        decodedAction:
          type:
            - string
            - 'null'
          description: Decoded function call (e.g. "transfer(0x71c7...976f, 50000000)").
        summary:
          type:
            - string
            - 'null'
          description: Human-readable summary of the transaction.
        blockReason:
          type:
            - string
            - 'null'
          description: Block reason if the intent failed due to policy.
        requiresApproval:
          type: boolean
          description: True if the intent is currently awaiting human approval.
        approvalId:
          type:
            - string
            - 'null'
          format: uuid
          description: Approval queue entry ID, if applicable.
        expiresAt:
          type:
            - string
            - 'null'
          format: date-time
          description: When the intent expires if not acted upon.
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Human-readable error message.
  securitySchemes:
    RuntimeKeyAuth:
      type: http
      scheme: bearer
      description: >-
        Runtime key issued at agent registration. Prefixed with `mndt_live_`
        (mainnet) or `mndt_test_` (testnet). Pass as `Authorization: Bearer
        mndt_test_...`.

````