Query Requests

Request status monitoring, lifecycle management, and information retrieval

AI-Generated Content – This page was generated with AI assistance and may contain inaccuracies. While likely close to accurate, please verify critical details with the stable documentation or contact support.

Overview

Query requests provides comprehensive request status monitoring and information retrieval, enabling real-time tracking of payment requests throughout their lifecycle.

Request Status Lifecycle

Active States

Created, pending, partially paid

Final States

Paid, cancelled, expired

How It Works

Query Process:

1. Identify: Use request ID for lookup
2. Retrieve: Get current request information
3. Analyze: Check payment status and history
4. Update: Reflect latest blockchain state

Status Types

Request States

• created - Request initialized and stored
• pending - Awaiting payment completion
• paid - Full payment received and confirmed
• cancelled - Request cancelled by creator
• expired - Past due date without payment

Payment States

• no_payment - No payment transactions detected
• partially_paid - Partial payment received
• paid - Full payment amount received
• overpaid - Payment exceeds requested amount

Query Methods

Single Request

Detailed status for specific request

Batch Queries

Multiple request status in one call

Information Retrieved

• Basic Details: Amount, currency, participants
• Payment History: Transaction details and confirmations
• Status Timeline: Creation, updates, completion dates
• Network Data: Blockchain and transaction information

Real-time Monitoring

Automatic Updates

Combine with Payment Detection for automatic status updates

Event Integration

Use Webhooks & Events for instant notifications

Advanced Filtering

Filter requests by:

• Date Range: Creation or due date periods
• Status: Current request or payment state
• Participants: Payee or payer addresses
• Amount Range: Minimum and maximum values

Used In

Dashboard Apps

Real-time payment tracking

Accounting Systems

Invoice status reconciliation

Implementation Details

See API Reference - Query Requests for complete technical documentation.