Skip to main content
GET
The Ping endpoint is a simple health check that allows you to:
  • Test connectivity to Modulus Labs servers
  • Verify API availability and response time
  • Confirm your network can reach the API endpoints
This endpoint does not require authentication, making it perfect for quick connectivity tests and uptime monitoring.
If you receive Pong!, the API is available and your network connectivity is working!

Use Cases

Connection Test

Verify your application can reach Modulus Labs servers

Health Monitoring

Include in your application’s health check endpoints

CI/CD Testing

Use in automated tests to verify API availability

Uptime Monitoring

Monitor API uptime and response times without authentication overhead

Monitoring Example

Include the Ping endpoint in your monitoring strategy:

Best Practices

Always set appropriate timeouts when making ping requests to avoid hanging your application.
Log health check failures for debugging and monitoring.
The ping endpoint is for health checks, not request validation. Don’t call it before every API request.Bad: Call ping before every QR creationGood: Call ping during startup and periodically for monitoring (every 1-5 minutes)

Troubleshooting

Symptom: Request times out without responsePossible Causes:
  • Firewall blocking outbound HTTPS requests
  • Network connectivity issues
  • DNS resolution problems
Solutions:
  • Check firewall rules allow HTTPS (port 443)
  • Test DNS resolution: nslookup qrph.sbx.moduluslabs.io
  • Try from a different network
  • Verify no proxy is blocking the request
Symptom: SSL/TLS certificate validation failsPossible Causes:
  • System time incorrect
  • Missing CA certificates
  • Corporate proxy intercepting SSL
Solutions:
  • Verify system time is correct
  • Update SSL certificates on your system
  • Configure proxy settings if applicable
Symptom: Response is not Pong!Possible Causes:
  • Wrong endpoint URL
  • Proxy or CDN modifying response
  • API maintenance or issues
Solutions:
  • Verify URL is exactly https://qrph.sbx.moduluslabs.io/ping
  • Check for any middleware modifying responses
  • Contact Modulus Labs support if issue persists

Next Steps

Create QR Code

Generate a Dynamic QR Ph for payments (requires authentication)

Authentication Guide

Set up HTTP Basic Auth for protected endpoints

Error Handling

Understand error codes and responses

QR API Introduction

Learn about the QR API features

Response

API is available and responding

The response is of type string.

Example:

"Pong!"