---
updatedAt: 2026-01-06T03:57:18.000Z
agentTools:
  projectIndex: https://developers.halaxy.com/llms.txt
---

# Troubleshooting Guide

Having issues? Refer to this quick guide to help you diagnose and fix common errors.

### Request details

* Are you using the correct resource reference links? Are you using the complete URL when referring to a specific resource? *(For example, when referencing a patient in your POST payload, you can't just enter the patient ID`123456789`. You must use `http://au-api.halaxy.com/main/Patient/123456789.`)*
* Are you using the correct ID prefix for the resource you are referencing? *(applies to Organization, Practitioner, PractitionerRole)*
* Are there symbols in your request? These can sometimes cause errors, so you may need to encode them.

### Authorization check

* Has the authorization token expired?
* Does the practice group have an active Halaxy API subscription?
* Are the API key and credentials still valid?
* Check the API Key Manager in Halaxy - does your API key have appropriate access for the request objective? *(You can check this in Settings > Integrations > External)*