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

# Read every live SEP-41 allowance the account has granted (architecture.md §12). Read-only.



## OpenAPI

````yaml /api-reference/openapi.json get /{network}/allowances/{address}
openapi: 3.0.0
info:
  title: LumenWipe API
  description: Programmatic close-out of Stellar accounts.
  version: 0.1.0
  contact: {}
servers:
  - url: https://api.lumenwipe.com
security: []
tags:
  - name: close
    description: Build and submit an account close-out
  - name: account
    description: Read account state and conversion paths
  - name: mediator
    description: Exchange-destination forwarding
  - name: health
    description: Service health
  - name: service
    description: Service index
  - name: admin
    description: Operator-only self-serve API key management
paths:
  /{network}/allowances/{address}:
    get:
      tags:
        - account
      summary: >-
        Read every live SEP-41 allowance the account has granted
        (architecture.md §12). Read-only.
      operationId: AccountController_allowances
      parameters:
        - name: network
          required: true
          in: path
          schema:
            enum:
              - testnet
              - mainnet
            type: string
        - name: address
          required: true
          in: path
          description: Stellar account (G...).
          schema:
            type: string
      responses:
        '200':
          description: Live, non-zero allowances, best effort.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AllowancesResultDto'
        '400':
          description: Invalid network or address.
        '401':
          description: Missing or invalid API key.
        '429':
          description: Rate limit exceeded for this key.
      security:
        - api-key: []
components:
  schemas:
    AllowancesResultDto:
      type: object
      properties:
        allowances:
          type: array
          items:
            $ref: '#/components/schemas/AllowanceDto'
        coverage:
          type: array
          items:
            $ref: '#/components/schemas/AllowanceCoverageDto'
        eventsScanned:
          description: >-
            The ledger range the event scan covered, or null if it ran out of
            budget before starting.
          nullable: true
          type: object
          allOf:
            - $ref: '#/components/schemas/EventsScannedDto'
        warnings:
          description: >-
            Plain-language warnings: a source that failed, candidates dropped by
            the cap.
          type: array
          items:
            $ref: '#/components/schemas/PlanBlockerDto'
      required:
        - allowances
        - coverage
        - eventsScanned
        - warnings
    AllowanceDto:
      type: object
      properties:
        token:
          type: string
          description: The token contract, C...
          example: CABC...XYZ
        tokenSymbol:
          type: string
          description: From the token's own symbol(), null when it does not answer.
          nullable: true
          example: USDC
        tokenDecimals:
          type: integer
          description: From the token's own decimals(), null when it does not answer.
          nullable: true
          example: 7
        spender:
          type: string
          description: >-
            The approved spender - almost always a contract (C...), occasionally
            an account (G...).
          example: CDEF...UVW
        spenderProtocol:
          type: string
          description: >-
            The spender's protocol, when its address resolves to a known DeFi
            contract registry entry. Null does not mean unsafe - most legitimate
            spenders simply aren't in the registry.
          enum:
            - blend
            - aquarius
            - soroswap
            - phoenix
            - fxdao
          nullable: true
        amount:
          type: string
          description: >-
            Base units, integer string, as allowance(from, spender) reports it
            live.
          example: '1000000000'
        expirationLedger:
          type: integer
          description: >-
            The ledger this allowance expires at, from the approve event that
            discovered it. Null when the amount is confirmed live but no
            matching approve event was found (e.g. aged out of the event scan's
            retention window) - the amount is still ground truth regardless.
          nullable: true
          example: 123456
        sources:
          type: array
          description: Every source that proposed this (token, spender) pair.
          items:
            type: string
            enum:
              - events
              - registry
      required:
        - token
        - tokenSymbol
        - tokenDecimals
        - spender
        - spenderProtocol
        - amount
        - expirationLedger
        - sources
    AllowanceCoverageDto:
      type: object
      properties:
        source:
          type: string
          enum:
            - events
            - registry
        status:
          type: string
          enum:
            - ok
            - failed
            - skipped
        detail:
          type: string
          description: Detail on a failed/skipped source.
      required:
        - source
        - status
    EventsScannedDto:
      type: object
      properties:
        fromLedger:
          type: number
          description: First ledger the event scan covered.
        toLedger:
          type: number
          description: Last ledger the event scan covered.
      required:
        - fromLedger
        - toLedger
    PlanBlockerDto:
      type: object
      properties:
        message:
          type: string
          description: Plain-language explanation.
        helpUrl:
          type: string
          description: A docs link with more detail.
        code:
          type: string
          description: >-
            Distinguishes an acknowledged, non-trapping warning (e.g. a chosen
            forfeit) from a hard blocker. Absent means the generic hard-blocking
            case.
      required:
        - message
  securitySchemes:
    api-key:
      scheme: bearer
      bearerFormat: opaque
      type: http
      description: Integrator API key

````

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