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

# Introspect a leased token

> Introspects a lease token. Returns RFC 7662–shaped fields — `active`, `connection_id`, `capability`, `scope`, `exp`, `iat` — for an external service to verify the token is still valid before honouring a callback. Tokens that are revoked, expired, or unrecognised return `active: false` with no further metadata.



## OpenAPI

````yaml /openapi.json post /lease-tokens/validate
openapi: 3.1.0
info:
  title: Marfa API
  version: 4.2.0
  description: Typed data layer for structured personal data
servers: []
security: []
paths:
  /lease-tokens/validate:
    post:
      tags:
        - Connection Leased Tokens
      summary: Introspect a leased token
      description: >-
        Introspects a lease token. Returns RFC 7662–shaped fields — `active`,
        `connection_id`, `capability`, `scope`, `exp`, `iat` — for an external
        service to verify the token is still valid before honouring a callback.
        Tokens that are revoked, expired, or unrecognised return `active: false`
        with no further metadata.
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                lease_token:
                  type: string
                  minLength: 1
              required:
                - lease_token
      responses:
        '200':
          description: >-
            Active flag plus lease metadata when active. Returns 200 with
            `active: false` for unknown / expired / revoked leases.
          content:
            application/json:
              schema:
                type: object
                properties:
                  active:
                    type: boolean
                  connection_id:
                    type: string
                  capability_id:
                    type: string
                  scopes:
                    type: array
                    items:
                      type: string
                  expires_at:
                    type: string
                required:
                  - active
        '400':
          description: Missing lease_token
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - validation_error
                          - missing_required_field
                      message:
                        type: string
                      details:
                        type: object
                        additionalProperties:
                          nullable: true
                    required:
                      - code
                      - message
                required:
                  - error

````