Connecting via the REST API
An introduction to the USystems REST API covering the base URL, authentication header, and a sample patient lookup request.
The USystems REST API lets you integrate patient, billing, and user data with your own tools and workflows. Every request is made over HTTPS against a tenant-specific base URL in the form https://api.usystems.io/v1/{tenant-id}/.
Authentication uses a bearer token. Every request must include an Authorization header in the form Authorization: Bearer YOUR_API_KEY. You can generate a key from Settings > Developer, as covered in a separate article.
Here's a simple example that fetches a single patient record by ID:
curl https://api.usystems.io/v1/{tenant-id}/patients/12345
-H "Authorization: Bearer YOUR_API_KEY"
A successful call returns a JSON object with the patient's demographic fields, record identifiers, and links to related resources such as appointments and invoices. Rate limits apply per API key, and current limits are always returned in the response headers so your integration can back off gracefully. Full endpoint documentation, including write operations, is available from the Developer Portal linked in Settings > Developer.
Was this helpful?