API Reference

The PayerGraph API is a REST API over HTTPS. Requests and responses are JSON. Authenticate with a bearer key; base URL https://api.payergraph.com.

All examples below use sandbox example data.

Errors

PayerGraph uses conventional HTTP status codes. Error bodies include a machine-readable code, a human message and a request_id for support.

{
  "error": {
    "code": "invalid_parameter",
    "message": "state must be a two-letter code",
    "param": "state",
    "request_id": "req_7f2k1"
  }
}

Rate limits

Default limits are applied per API key and returned in X-RateLimit-* headers. Exceeding a limit returns 429 rate_limit_exceeded with a Retry-After header. Batch endpoints count each code in the batch toward volume limits. Contact us to raise limits for production workloads.