Timeout

To ensure consistent performance and predictable behavior, API People APIs enforce a timeout limit for all endpoints unless otherwise specified in the individual API reference.

Timeout Policy

All API requests must complete within 180 seconds (3 minutes). This window accounts for variability in response times from upstream systems such as bank cores or third‑party integrations.

If a request exceeds 180 seconds, the client receives a 504 Gateway Timeout response. See an example in the code snippet below.

{
  "apiName": "ACH Payments API",
  "version": "v1",
  "correlationId": "679751e0-36ba-49a1-b992-599c75beec66",
  "timestamp": "2025-06-05T10:12:43.642286-07:00",
  "errorDetails": {
    "code": "504",
    "reason": "TIMEOUT",
    "details": "Timeout Received"
  }
}

Retries

Use exponential backoff for transient delays to avoid overwhelming the system.