> ## 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 credential metadata

> Returns at most 100 active-first/recent credential metadata entries plus tradingview_available.

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

## Authorization

Authenticated Liftx Settings session; no API-key authorization.

## Behavior

Returns at most 100 active-first/recent credential metadata entries plus tradingview\_available. Metadata never recovers a secret. Inspection remains available after entitlement expiry. Availability is an activation signal, not proof every market is ready.

This is a session-owned application contract, not an ordinary API-key endpoint. Use [Settings → Integrations](https://app.liftx.io/settings/integrations). The public API base URL does not grant session access.

## Request example

```http theme={null}
GET /integrations/credentials
```

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/settings-contract) for lifecycle, units and recovery semantics.


## OpenAPI

````yaml api/openapi.json GET /integrations/credentials
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:
  /integrations/credentials:
    get:
      summary: List credential metadata and TradingView availability
      description: >-
        Session-owned Settings contract. Ordinary API keys and TradingView
        capabilities cannot authenticate this route. Use the Liftx Settings
        application; this is not a third-party bot endpoint. Returns at most 100
        credential metadata rows, active first then recent history. Inactive
        credentials become eligible for bounded cleanup 30 days after their own
        expiry/revocation once no retained command references them. Parent
        revocation disables authorization immediately; key metadata ages by its
        own expiry/revocation. Nonrevoked keyless TradingView setups and all
        lifecycle references are preserved.
      operationId: get_integrations_credentials
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  credentials:
                    type: array
                    items:
                      $ref: '#/components/schemas/Credential'
                  tradingview_available:
                    type: boolean
                required:
                  - credentials
                  - tradingview_available
                additionalProperties: false
              examples:
                synthetic:
                  summary: Synthetic credential metadata; webhook remains inactive
                  description: >-
                    Synthetic documentation data, not an account snapshot,
                    executable market configuration or production-availability
                    assertion. IDs, quantities, prices, times and values are
                    illustrative.
                  value:
                    credentials:
                      - id: 77777777-7777-4777-8777-777777777777
                        integration_id: 88888888-8888-4888-8888-888888888888
                        name: Demo controller
                        kind: api
                        prefix: lx_api_77777777
                        scopes:
                          - read
                          - positions:open
                          - positions:modify
                          - positions:terminate
                        exchange_link_ids:
                          - 17
                        instrument_ids:
                          - COPY_EXACT_CATALOG_ID
                        created_at: 1893456000
                        expires_at: 1893542400
                        revoked_at: null
                    tradingview_available: false
        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:
        - SessionBearer: []
components:
  schemas:
    Credential:
      type: object
      properties:
        id:
          type: string
          format: uuid
        integration_id:
          type: string
          format: uuid
        name:
          type: string
        kind:
          type: string
        prefix:
          type: string
        scopes:
          type: array
          items:
            type: string
        exchange_link_ids:
          type: array
          items:
            type: integer
            format: int64
        instrument_ids:
          type: array
          items:
            type: string
        created_at:
          type: integer
          format: int64
        expires_at:
          type: integer
          format: int64
        revoked_at:
          anyOf:
            - type: integer
              format: int64
            - type: 'null'
      required:
        - id
        - integration_id
        - name
        - kind
        - prefix
        - scopes
        - exchange_link_ids
        - instrument_ids
        - created_at
        - expires_at
        - revoked_at
      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
  securitySchemes:
    SessionBearer:
      type: http
      scheme: bearer
      bearerFormat: existing authenticated Liftx session

````

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