Skip to main content
API Base URLs
Sandbox
https://api.sandbox.parchmenthealth.io/external
Production
https://api.parchmenthealth.io/external

​
Overview

The Parchment Health API is a RESTful API that allows you to manage your Patient information in Parchment. Our API follows industry standards including RFC 7807 for error responses and provides consistent, predictable response formats across all endpoints.
Server-to-server only. The Parchment API does not support browser or other client-side calls. CORS is not enabled, and x-organization-secret (along with the bearer token derived from it) is a long-lived shared credential that must never be exposed in frontend code. All requests must originate from your backend — proxy any client-facing data through your own server.

​
Getting Started

Once you’ve received your sandbox credentials from Parchment, follow these steps to start using the API.

Sign up to the Parchment sandbox

Create your partner account in the Parchment sandbox environment.

Generate API credentials

Generate your API client credentials from the Parchment sandbox portal.

Connect each organization

Call the /validate endpoint for each organization you need to connect so that the organization is linked to your integration. See Partner Token Creation for details.

Implement the relevant APIs

Implement the Parchment APIs that are relevant to your business workflows (patients, users, prescriptions, SSO, iFrame etc.).

Test your implementation

Validate end-to-end behaviour against the sandbox environment to ensure your integration works as expected.

Request the conformance form

Request the conformance form from Parchment once your sandbox implementation is complete.

​
Response Structure

All API responses follow a standardized format. See the Response Standards section for detailed information about success and error response formats.