> ## Documentation Index > Fetch the complete documentation index at: https://docs.request.network/llms.txt > Use this file to discover all available pages before exploring further. # Get request status > Get the status of a payment request ## OpenAPI ````yaml /api-reference/openapi.v2.json get /v2/request/{requestId} openapi: 3.0.0 info: title: Request Network API description: API for easily creating and paying Requests with Request Network. version: 0.13.0 contact: {} servers: - url: https://api.request.network description: Production server - url: https://api.stage.request.network description: Staging server - url: http://127.0.0.1:8080 description: Local development server security: [] tags: - name: V2/Request description: Core payment request operations (V2) - name: V2/Payments description: Payment search and management operations (V2) - name: V2/Payouts description: Pay a request without creating one first (V2) - name: V2/Payer description: Crypto-to-fiat payer management operations (V2) - name: V2/Currencies description: Currency operations (V2) - name: V2/Client IDs description: Client ID management (V2) - name: V2/Payee Destination description: Payee destination management (V2) externalDocs: description: Request Network Docs url: https://docs.request.network/request-network-api paths: /v2/request/{requestId}: get: tags: - Request - V2/Request summary: Get request status description: Get the status of a payment request operationId: RequestControllerV2_getRequestStatus_v2 parameters: - name: requestId required: true in: path description: The requestId for the request schema: example: 01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb type: string - name: x-api-key in: header description: API key for authentication (optional if using Client ID) required: false schema: type: string - name: x-client-id in: header description: Client ID for frontend authentication (optional if using API key) required: false schema: type: string - name: Origin in: header description: >- Origin header (required for Client ID auth, automatically set by browser) required: false schema: type: string responses: '200': description: Request status retrieved successfully content: application/json: schema: type: object properties: hasBeenPaid: type: boolean description: Whether the request has been paid paymentReference: type: string description: Unique identifier used for payments and status checks requestId: type: string description: Unique identifier of the request isListening: type: boolean description: >- Whether the system is actively listening for payments on this request txHash: type: string nullable: true description: Transaction hash of the payment, null if not yet paid recurrence: type: object description: Recurrence configuration for recurring requests originalRequestId: type: string description: Original request ID for recurring requests status: type: string description: Current status of the request isCryptoToFiatAvailable: type: boolean description: >- Whether crypto-to-fiat conversion is available for this request originalRequestPaymentReference: type: string description: >- Payment reference of the original request for recurring payments payments: type: array description: Array of payments made to this request items: type: object isRecurrenceStopped: type: boolean description: Whether recurrence has been stopped for this request customerInfo: type: object nullable: true description: Customer information for merchant receipt tracking properties: firstName: type: string description: Customer's first name lastName: type: string description: Customer's last name email: type: string description: Customer's email address address: type: object description: Customer's address properties: street: type: string description: Street address city: type: string description: City state: type: string description: State or province postalCode: type: string description: Postal or ZIP code country: type: string description: Country code (ISO 3166-1 alpha-2) reference: type: string nullable: true description: Merchant reference for receipt tracking and identification amountInUsd: type: string nullable: true description: >- Request amount in USD (actual if paid, current market rate if unpaid) conversionRate: type: string nullable: true description: >- Conversion rate. Available for: unpaid requests and fully paid requests with single payment. Null for: partially paid requests and fully paid requests with multiple payments. rateSource: type: string enum: - lifi - chainlink - coingecko - unknown - mixed description: Source of the conversion rate conversionBreakdown: type: object nullable: true description: >- Detailed breakdown for partial payments or multiple payments. Provides individual payment rates when top-level rate is null. properties: paidAmount: type: string paidAmountInUsd: type: string remainingAmount: type: string remainingAmountInUsd: type: string currentMarketRate: type: string nullable: true currentMarketRateSource: type: string enum: - lifi - chainlink - coingecko - unknown nullable: true payments: type: array items: type: object properties: amount: type: string amountInUsd: type: string conversionRate: type: string rateSource: type: string enum: - lifi - chainlink - coingecko - unknown timestamp: type: string fees: type: array nullable: true description: Associated fees (actual if paid, empty if unpaid) items: type: object properties: type: type: string enum: - gas - platform - crosschain - crypto-to-fiat - offramp description: Type of fee provider: type: string description: Fee provider amount: type: string description: >- Fee amount in human-readable format (formatted with token decimals) currency: type: string description: Fee currency examples: paid: summary: Request has been paid value: hasBeenPaid: true requestId: >- 01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb isListening: false txHash: >- 0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef notPaid: summary: Request has not been paid value: hasBeenPaid: false requestId: >- 01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb isListening: false txHash: null withCustomerInfo: summary: Request with customer information and reference value: hasBeenPaid: false requestId: >- 01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb isListening: true txHash: null customerInfo: firstName: John lastName: Doe email: john.doe@example.com address: street: 123 Main Street city: New York state: NY postalCode: '10001' country: US reference: ORDER-2024-001234 paidWithUsdInfo: summary: Fully paid request with single payment value: hasBeenPaid: true requestId: >- 01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb paymentReference: '0xb3581f0b0f74cc61' amountInUsd: '100.00' conversionRate: '2487.52' rateSource: coingecko fees: - type: platform provider: request-network amount: '2.00' currency: USDC - type: gas provider: sepolia amount: '0.002' currency: ETH partiallyPaidWithBreakdown: summary: Partially paid request (conversion rate is null) value: hasBeenPaid: false requestId: >- 01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb paymentReference: '0xb3581f0b0f74cc61' amountInUsd: '100.12' conversionRate: null rateSource: mixed conversionBreakdown: paidAmount: '75.00' paidAmountInUsd: '75.00' remainingAmount: '25.00' remainingAmountInUsd: '25.12' currentMarketRate: '2501.23' currentMarketRateSource: coingecko payments: - amount: '75.00' amountInUsd: '75.00' conversionRate: '2487.52' rateSource: chainlink timestamp: '2025-01-01T10:00:00Z' fees: - type: platform provider: request-network amount: '1.50' currency: USDC - type: gas provider: sepolia amount: '0.0015' currency: ETH unpaidRequest: summary: Unpaid request with current market rates value: hasBeenPaid: false requestId: >- 01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb paymentReference: '0xb3581f0b0f74cc61' amountInUsd: '100.25' conversionRate: '2501.23' rateSource: coingecko fees: [] multiplePayments: summary: >- Fully paid request with multiple payments (conversion rate is null) value: hasBeenPaid: true requestId: >- 01e273ecc29d4b526df3a0f1f05ffc59372af8752c2b678096e49ac270416a7cdb paymentReference: '0xb3581f0b0f74cc61' amountInUsd: '100.00' conversionRate: null rateSource: mixed conversionBreakdown: paidAmount: '100.00' paidAmountInUsd: '100.00' remainingAmount: '0' remainingAmountInUsd: '0' currentMarketRate: null currentMarketRateSource: null payments: - amount: '50.00' amountInUsd: '50.00' conversionRate: '2500.00' rateSource: coingecko timestamp: '2025-01-01T10:00:00Z' - amount: '50.00' amountInUsd: '50.00' conversionRate: '2480.30' rateSource: chainlink timestamp: '2025-01-02T15:30:00Z' fees: - type: platform provider: request-network amount: '2.00' currency: USDC - type: gas provider: sepolia amount: '0.002' currency: ETH - type: crosschain provider: lifi amount: '0.05' currency: USDC '404': description: Request not found '429': description: Too Many Requests ````