curl --request GET \
  --url https://api.sandbox.paypathiq.com/v1/clients/{clientCode}/source-freshness \
  --header 'Authorization: Bearer <token>'

{
  "basis": "Nightly core-banking export plus a 12 hour tolerance",
  "evaluatedAt": "2026-10-15T12:00:00Z",
  "heldReason": null,
  "lastEvidenceAt": "2026-10-15T02:15:00Z",
  "limitSeconds": 129600,
  "paymentInitiationHeld": false,
  "recoveryHeld": false,
  "staleAt": "2026-10-16T14:15:00Z",
  "state": "fresh"
}

{
  "detail": "API key is invalid, inactive, revoked, or for another environment.",
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 401,
  "title": "API key is invalid, inactive, revoked, or for another environment.",
  "type": "https://docs.paypathiq.com/problems/invalid_api_key"
}

{
  "detail": "The Client code is unknown, the grant lacks the required scope, or the calling address is outside the grant's IP allowlist.",
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 403,
  "title": "The Client code is unknown, the grant lacks the required scope, or the calling address is outside the grant's IP allowlist.",
  "type": "https://docs.paypathiq.com/problems/client_scope_denied"
}

{
  "detail": "Route parameters or the representation are invalid. Route parameters are checked before authentication. Field errors carry a code such as invalid_format, unrecognized_keys, custom, sensitive_external_id, or sensitive_source_reference.",
  "errors": [
    {
      "code": "invalid_format",
      "detail": "Invalid ISO date",
      "pointer": "/dueDate"
    }
  ],
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 422,
  "title": "Route parameters or the representation are invalid. Route parameters are checked before authentication. Field errors carry a code such as invalid_format, unrecognized_keys, custom, sensitive_external_id, or sensitive_source_reference.",
  "type": "https://docs.paypathiq.com/problems/validation_error"
}

{
  "detail": "Each API key may send 60 requests per minute and run 1 request at a time. In sandbox, the same limits also apply per Client across all of its keys. Every request, including GET, counts.",
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 429,
  "title": "Each API key may send 60 requests per minute and run 1 request at a time. In sandbox, the same limits also apply per Client across all of its keys. Every request, including GET, counts.",
  "type": "https://docs.paypathiq.com/problems/rate_limit_exceeded"
}

{
  "detail": "An unexpected error prevented a safe commit, and nothing was saved. Retry with backoff.",
  "requestId": "29400000-0000-4000-8000-000000000001",
  "status": 503,
  "title": "An unexpected error prevented a safe commit, and nothing was saved. Retry with backoff.",
  "type": "https://docs.paypathiq.com/problems/projection_unavailable"
}