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

# Get the public status of a request by `referenceId`

> Returns the stored remittance aggregate or **404** when no snapshot exists.



## OpenAPI

````yaml /request-api/openapi.yaml get /v1/request-money/{referenceId}
openapi: 3.0.0
info:
  title: Request API
  description: >-
    HTTP request-money API. OpenAPI specification generated from NestJS
    controllers and DTOs.
  version: 0.2.0
  contact: {}
servers:
  - url: https://{raas-backend-sandbox}
    description: >-
      RaaS Widgets backend (sandbox) — versioned routes live under /v1 (e.g.
      POST /v1/request-money)
    variables:
      raas-backend-sandbox:
        default: raas-backend-sandbox.example.com
        description: Concrete sandbox host provided by your integration contact
  - url: https://{raas-backend-production}
    description: RaaS Widgets backend (production) — versioned routes live under /v1
    variables:
      raas-backend-production:
        default: raas-backend-production.example.com
        description: Concrete production host provided by your integration contact
security: []
tags: []
paths:
  /v1/request-money/{referenceId}:
    get:
      tags:
        - request-money
      summary: Get the public status of a request by `referenceId`
      description: >-
        Returns the stored remittance aggregate or **404** when no snapshot
        exists.
      operationId: getByReferenceId
      parameters:
        - name: referenceId
          required: true
          in: path
          schema:
            pattern: ^[a-zA-Z0-9]{8}$
            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestMoneyResponseDto'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiKeyUnauthorizedDto'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RequestMoneyNotFoundDto'
        '422':
          description: Validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationFailedDto'
      security:
        - api_key: []
components:
  schemas:
    RequestMoneyResponseDto:
      type: object
      properties:
        status:
          type: string
          description: >-
            Public lifecycle status for the operation.


            | API value | Display label | Stage / party | Meaning |

            | --- | --- | --- | --- |

            | `pending` | Pending | System / requester | Awaiting payer action.
            |

            | `processing` | Processing | Payer / gateway | Payment in progress;
            not yet final. |

            | `completed` | Completed | Payment gateway | Successfully settled.
            |

            | `rejected` | Rejected | Payer | Payer declined the payment. |

            | `cancelled` | Cancelled | Requester | Issuer cancelled the
            operation or it expired. |
          example: pending
          enum:
            - pending
            - processing
            - completed
            - rejected
            - cancelled
        referenceId:
          type: string
          description: >-
            Partner-provided operation code echoed from the create request (8
            alphanumeric characters).
          example: Ab3xY9mK
        id:
          type: string
        statusDetails:
          type: string
          description: Details about the status of the operation.
          example: >-
            The operation is pending because the sender has not yet started the
            process.
        waLink:
          type: string
          description: Absolute WhatsApp link for the operation.
          example: >-
            https://wa.me/502123456789?text=Hola%20Juan,%20te%20enviamos%20una%20solicitud%20de%20dinero%20para%20pagar%20tu%20factura%20de%20agua#QWERTY
        landingLink:
          type: string
          description: Absolute landing page URL for the operation.
          example: https://landing.com/request-money/qwer-12345
      required:
        - status
        - referenceId
        - id
        - statusDetails
        - waLink
        - landingLink
    ApiKeyUnauthorizedDto:
      type: object
      properties:
        message:
          type: string
          description: Human-readable reason.
      required:
        - message
    RequestMoneyNotFoundDto:
      type: object
      properties:
        error:
          type: string
          description: Stable machine-readable code.
          example: not_found
        message:
          type: string
          description: Human-readable explanation you can show to operators or end users.
          example: >-
            No request-money operation exists for this API key and referenceId.
            Verify the referenceId or create a new request first.
      required:
        - error
        - message
    ValidationFailedDto:
      type: object
      properties:
        message:
          type: string
          example: Validation failed
        details:
          type: object
          description: Validation error tree; for JSON bodies errors are under `body`.
          additionalProperties: true
      required:
        - message
        - details
  securitySchemes:
    api_key:
      type: apiKey
      in: header
      name: X-API-Key
      description: Integrator API key.

````