API Reference

A comprehensive reference for using the Chariot API endpoints

The Chariot API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Issues, Ideas or Feedback

If you feel like something is missing from our API docs, feel free to create an Issue on our OpenAPI GitHub repo.

API protocols and headers

The Chariot API uses standard HTTP response codes to indicate status and errors. All responses come in standard JSON. The Chariot API is served over HTTPS TLS v1.2+ to ensure data privacy; HTTP and HTTPS with TLS versions below 1.2 are not supported. All requests with a payload must include a Content-Type of application/JSON and the body must be valid JSON.

Every Chariot API response includes a request_id as the X-Request-Id header. The request_id is included whether the API request succeeded or failed. For faster support, include the request_id when contacting support regarding a specific API call.

API host

Chariot has two environments: Sandbox and Production. The Sandbox environment supports only test data. All activity in the Production environment is real.

Production API requests should be to https://api.givechariot.com and sandbox requests should be to https://sandboxapi.givechariot.com.

When you’re getting ready to launch into production, please let us know by emailing support@givechariot.com to get your production credentials. We strongly encourage you to read through the Implementation Guide to understand best practices for creating a successful DAFpay integration with Chariot.

Was this page helpful?