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

# Read a limit request

> This endpoint reads a single limit-increase request for a customer.



## OpenAPI

````yaml /openapi/api-production.yaml get /customers/{id}/limit-requests/{limitRequestId}
openapi: 3.1.0
info:
  version: 1.0.0
  title: Lumx API
  description: >-
    A cross-border banking API with instant settlements and unmatched liquidity,
    powered by stablecoins.
servers:
  - url: https://api.lumx.io
  - url: https://api-sandbox.lumx.io
security: []
paths:
  /customers/{id}/limit-requests/{limitRequestId}:
    get:
      tags:
        - Customers
      summary: Read a limit request
      description: This endpoint reads a single limit-increase request for a customer.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Customer's unique identifier.
        - name: limitRequestId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Limit request's unique identifier.
      responses:
        '200':
          description: Resource successfully retrieved.
          content:
            application/json:
              examples:
                InReview:
                  $ref: '#/components/examples/LimitRequestResponseExample'
                Approved:
                  $ref: '#/components/examples/LimitRequestApprovedExample'
                PartiallyApproved:
                  $ref: '#/components/examples/LimitRequestPartiallyApprovedExample'
                Rejected:
                  $ref: '#/components/examples/LimitRequestRejectedExample'
              schema:
                $ref: '#/components/schemas/LimitRequestResponse'
      security:
        - apiKey: []
components:
  examples:
    LimitRequestResponseExample:
      value:
        id: b2e1a2d4-1234-4a3b-9c4d-5e6f7a8b9c0d
        customerId: 3c90c3cc-0d44-4b50-8888-8dd25736052a
        requested:
          single: '15000.00'
          daily: '60000.00'
          monthly: '120000.00'
        approved:
          single: null
          daily: null
          monthly: null
        supportingDocumentType: LIMIT_REQUEST_BANK_STATEMENT
        supportingDocumentId: 9d1e2f3a-4b5c-6d7e-8f90-1a2b3c4d5e6f
        status: IN_REVIEW
        reviewComment: null
        createdAt: '2024-01-15T10:00:00Z'
        updatedAt: '2024-01-15T10:00:00Z'
    LimitRequestApprovedExample:
      value:
        id: b2e1a2d4-1234-4a3b-9c4d-5e6f7a8b9c0d
        customerId: 3c90c3cc-0d44-4b50-8888-8dd25736052a
        requested:
          single: '15000.00'
          daily: '60000.00'
          monthly: '120000.00'
        approved:
          single: '15000.00'
          daily: '60000.00'
          monthly: '120000.00'
        supportingDocumentType: LIMIT_REQUEST_BANK_STATEMENT
        supportingDocumentId: 9d1e2f3a-4b5c-6d7e-8f90-1a2b3c4d5e6f
        status: APPROVED
        reviewComment: null
        createdAt: '2024-01-15T10:00:00Z'
        updatedAt: '2024-01-15T10:05:00Z'
    LimitRequestPartiallyApprovedExample:
      value:
        id: b2e1a2d4-1234-4a3b-9c4d-5e6f7a8b9c0d
        customerId: 3c90c3cc-0d44-4b50-8888-8dd25736052a
        requested:
          single: '15000.00'
          daily: '60000.00'
          monthly: '120000.00'
        approved:
          single: '7500.00'
          daily: '30000.00'
          monthly: '60000.00'
        supportingDocumentType: LIMIT_REQUEST_BANK_STATEMENT
        supportingDocumentId: 9d1e2f3a-4b5c-6d7e-8f90-1a2b3c4d5e6f
        status: PARTIALLY_APPROVED
        reviewComment: >-
          Limits approved at 50% of the requested amounts based on the
          supporting document.
        createdAt: '2024-01-15T10:00:00Z'
        updatedAt: '2024-01-15T10:05:00Z'
    LimitRequestRejectedExample:
      value:
        id: b2e1a2d4-1234-4a3b-9c4d-5e6f7a8b9c0d
        customerId: 3c90c3cc-0d44-4b50-8888-8dd25736052a
        requested:
          single: '15000.00'
          daily: '60000.00'
          monthly: '120000.00'
        approved:
          single: null
          daily: null
          monthly: null
        supportingDocumentType: LIMIT_REQUEST_BANK_STATEMENT
        supportingDocumentId: 9d1e2f3a-4b5c-6d7e-8f90-1a2b3c4d5e6f
        status: REJECTED
        reviewComment: The supporting document does not justify the requested limits.
        createdAt: '2024-01-15T10:00:00Z'
        updatedAt: '2024-01-15T10:05:00Z'
  schemas:
    LimitRequestResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Limit request's unique identifier.
          example: b2e1a2d4-1234-4a3b-9c4d-5e6f7a8b9c0d
        customerId:
          type: string
          description: Customer's unique identifier.
          format: uuid
          example: 3c90c3cc-0d44-4b50-8888-8dd25736052a
        requested:
          type: object
          description: Limits requested by the customer.
          properties:
            single:
              type: string
              nullable: true
              example: '15000.00'
            daily:
              type: string
              nullable: true
              example: '60000.00'
            monthly:
              type: string
              nullable: true
              example: '120000.00'
        approved:
          type: object
          description: Limits approved by compliance. Each value is null until reviewed.
          properties:
            single:
              type: string
              nullable: true
              example: null
            daily:
              type: string
              nullable: true
              example: null
            monthly:
              type: string
              nullable: true
              example: null
        supportingDocumentType:
          type: string
          nullable: true
          example: LIMIT_REQUEST_BANK_STATEMENT
        supportingDocumentId:
          type: string
          nullable: true
          example: 9d1e2f3a-4b5c-6d7e-8f90-1a2b3c4d5e6f
        status:
          type: string
          description: Current status of the limit request.
          enum:
            - IN_REVIEW
            - APPROVED
            - PARTIALLY_APPROVED
            - REJECTED
          example: IN_REVIEW
        reviewComment:
          type: string
          nullable: true
          description: Compliance's comment. Set when rejected or partially approved.
          example: null
        createdAt:
          type: string
          format: date-time
          example: '2024-01-15T10:00:00Z'
        updatedAt:
          type: string
          format: date-time
          description: Also the review timestamp once the request leaves IN_REVIEW.
          example: '2024-01-15T10:00:00Z'
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Bearer authentication header on the format `Bearer <API_KEY>`.

````