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

# List command receipts

> Returns at most 50 top-level receipts and nullable next_cursor.

<Note>Preview contract. Production availability remains subject to activation and release qualification. Examples are synthetic; the documentation cannot submit requests.</Note>

## Authorization

Any valid API key for its own integration namespace.

## Behavior

Returns at most 50 top-level receipts and nullable next\_cursor. Pass the returned cursor unchanged for older commands. Group children are represented by their parent summary; request detail for child outcomes. This is namespace history, not all account Activity.

## Request example

```http theme={null}
GET /v1/commands
Authorization: Bearer YOUR_API_KEY_FROM_PRIVATE_STORAGE
```

All IDs and dates are illustrative. URL-encode opaque query values and supply each allowed key once. Optional filters and their types appear in the generated schema below.

## Response and errors

The generated response schema below is the wire contract. Preserve fixed-point strings, nullable fields and endpoint-specific envelopes. Inspect HTTP status and Content-Type before decoding failures; reused trading routes may return JSON or plain text. Authentication, entitlement and exact link/instrument restrictions apply in addition to endpoint validation. See [errors and recovery](/api/errors-and-limits).

Read the [related guide](/api/commands-and-receipts) for lifecycle, units and recovery semantics.


## OpenAPI

````yaml api/openapi.json GET /v1/commands
openapi: 3.1.0
info:
  title: Liftx integrations
  version: 1.0.0
  description: >-
    Preview contract for the Liftx API, TradingView webhook and session-owned
    integration settings. Production availability is pending activation and
    release qualification. External access requires Pro or trial entitlement and
    is unmetered within bounded resource limits. Receipt acceptance does not
    confirm execution completion. MCP is not active.
servers:
  - url: https://api.liftx.io
security: []
paths:
  /v1/commands:
    get:
      summary: List namespace command receipts
      operationId: get_v1_commands
      parameters:
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReceiptPage'
              examples:
                page:
                  summary: Synthetic top-level receipt page
                  description: >-
                    Synthetic documentation data, not an account snapshot,
                    executable market configuration or production-availability
                    assertion. IDs, quantities, prices, times and values are
                    illustrative.
                  value:
                    commands:
                      - id: 99999999-9999-4999-8999-999999999999
                        client_command_id: signal-a:exit-001
                        action: terminate
                        state: partial
                        position_id: null
                        error_code: null
                        created_at: 1893456000
                        updated_at: 1893456060
                        group:
                          target: strategy
                          target_count: 2
                          counts:
                            accepted: 0
                            dispatching: 0
                            execution_observed: 0
                            handed_off: 1
                            rejected: 0
                            expired: 1
                            operator_required: 0
                      - id: 22222222-2222-4222-8222-222222222222
                        client_command_id: demo-controller:cycle-001:open
                        action: open
                        state: handed_off
                        position_id: 11111111-1111-4111-8111-111111111111
                        error_code: null
                        created_at: 1893456000
                        updated_at: 1893456001
                    next_cursor: null
                empty:
                  summary: Synthetic empty receipt history
                  description: >-
                    Synthetic documentation data, not an account snapshot,
                    executable market configuration or production-availability
                    assertion. IDs, quantities, prices, times and values are
                    illustrative.
                  value:
                    commands: []
                    next_cursor: null
        default:
          description: >-
            Integration errors use Error; existing trading handlers retain their
            own JSON or text/plain error codec. Inspect status and content type.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            text/plain:
              schema:
                type: string
      security:
        - ApiKey: []
components:
  schemas:
    ReceiptPage:
      type: object
      properties:
        commands:
          type: array
          items:
            $ref: '#/components/schemas/Receipt'
        next_cursor:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
      required:
        - commands
        - next_cursor
      additionalProperties: false
    Error:
      type: object
      properties:
        success:
          const: false
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
          additionalProperties: false
      required:
        - success
        - error
      additionalProperties: false
    Receipt:
      type: object
      properties:
        id:
          type: string
          format: uuid
        client_command_id:
          type: string
        action:
          type: string
        state:
          type: string
          enum:
            - accepted
            - dispatching
            - handed_off
            - execution_observed
            - rejected
            - expired
            - operator_required
            - partial
        position_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
        error_code:
          anyOf:
            - type: string
            - type: 'null'
        created_at:
          type: integer
          format: int64
        updated_at:
          type: integer
          format: int64
        terminal_request_kind:
          type: integer
          enum:
            - 1
            - 2
        terminal_request_seq:
          type: integer
          format: int64
          minimum: 1
        group_id:
          type: string
          format: uuid
          description: Parent group on a child termination receipt.
        group:
          $ref: '#/components/schemas/GroupProgress'
        targets:
          type: array
          maxItems: 64
          items:
            $ref: '#/components/schemas/GroupTargetReceipt'
          description: >-
            Group detail only: at most 64 frozen ordinary termination receipts.
            Targets cannot contain nested groups or target arrays. Omitted on
            list responses and zero-target groups.
      required:
        - id
        - client_command_id
        - action
        - state
        - position_id
        - error_code
        - created_at
        - updated_at
      additionalProperties: false
      description: >-
        Durable command receipt, never a fill/completion assertion. Terminal
        request fields correlate a durable termination owner handoff. Terminal
        arm writes kind/sequence while retaining dispatching; owner return or
        startup canonical evidence advances handed_off. Group parent position_id
        is null. Precedence is operator_required, dispatching, accepted, then
        homogeneous resolved state or partial. Zero-target parent is
        execution_observed. Counts and child states do not prove exposure is
        flat.
      dependentRequired:
        terminal_request_kind:
          - terminal_request_seq
        terminal_request_seq:
          - terminal_request_kind
        targets:
          - group
      allOf:
        - if:
            required:
              - group
          then:
            properties:
              position_id:
                type: 'null'
              action:
                const: terminate
            not:
              anyOf:
                - required:
                    - group_id
                - required:
                    - terminal_request_kind
                - required:
                    - terminal_request_seq
    GroupProgress:
      type: object
      properties:
        target:
          type: string
          enum:
            - strategy
            - market
        target_count:
          type: integer
          minimum: 0
          maximum: 64
        counts:
          type: object
          properties:
            accepted:
              type: integer
              minimum: 0
              maximum: 64
            dispatching:
              type: integer
              minimum: 0
              maximum: 64
            execution_observed:
              type: integer
              minimum: 0
              maximum: 64
            handed_off:
              type: integer
              minimum: 0
              maximum: 64
            rejected:
              type: integer
              minimum: 0
              maximum: 64
            expired:
              type: integer
              minimum: 0
              maximum: 64
            operator_required:
              type: integer
              minimum: 0
              maximum: 64
          required:
            - accepted
            - dispatching
            - execution_observed
            - handed_off
            - rejected
            - expired
            - operator_required
          additionalProperties: false
      required:
        - target
        - target_count
        - counts
      additionalProperties: false
      description: >-
        Counts sum to the immutable target_count. Zero targets records an
        observed empty selection, not market flatness.
    GroupTargetReceipt:
      type: object
      description: >-
        One captured termination target in a group receipt. Targets are ordinary
        command receipts, never nested groups. Each identifies its frozen
        position and parent group. Its state and durable terminal-request fields
        do not prove exposure is flat.
      properties:
        id:
          type: string
          format: uuid
        client_command_id:
          type: string
        action:
          type: string
          const: terminate
          description: Every captured group target is an ordinary termination command.
        state:
          type: string
          enum:
            - accepted
            - dispatching
            - handed_off
            - execution_observed
            - rejected
            - expired
            - operator_required
        position_id:
          type: string
          format: uuid
          description: Exact position UUID frozen into this group target at admission.
        error_code:
          anyOf:
            - type: string
            - type: 'null'
        created_at:
          type: integer
          format: int64
        updated_at:
          type: integer
          format: int64
        terminal_request_kind:
          type: integer
          enum:
            - 1
            - 2
        terminal_request_seq:
          type: integer
          format: int64
          minimum: 1
        group_id:
          type: string
          format: uuid
          description: Exact parent group UUID; always present on a captured target.
      required:
        - id
        - client_command_id
        - action
        - state
        - position_id
        - error_code
        - created_at
        - updated_at
        - group_id
      additionalProperties: false
      dependentRequired:
        terminal_request_kind:
          - terminal_request_seq
        terminal_request_seq:
          - terminal_request_kind
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: lx_api_<credential UUID>.<256-bit secret>

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.