> This page is for version 0.0.60.
> For other versions, use one of these documentation indexes:
> - 0.0.79 (default): https://docs.refer.health.gov.sg/0-0-79/llms.txt
> - 0.0.78: https://docs.refer.health.gov.sg/0-0-78/llms.txt
> - 0.0.77: https://docs.refer.health.gov.sg/0-0-77/llms.txt
> - 0.0.76: https://docs.refer.health.gov.sg/0-0-76/llms.txt
> - 0.0.75: https://docs.refer.health.gov.sg/0-0-75/llms.txt
> - 0.0.74: https://docs.refer.health.gov.sg/0-0-74/llms.txt
> - 0.0.73: https://docs.refer.health.gov.sg/0-0-73/llms.txt
> - 0.0.72: https://docs.refer.health.gov.sg/0-0-72/llms.txt
> - 0.0.71: https://docs.refer.health.gov.sg/0-0-71/llms.txt
> - 0.0.70: https://docs.refer.health.gov.sg/0-0-70/llms.txt
> - 0.0.69: https://docs.refer.health.gov.sg/0-0-69/llms.txt
> - 0.0.68: https://docs.refer.health.gov.sg/0-0-68/llms.txt
> - 0.0.67: https://docs.refer.health.gov.sg/0-0-67/llms.txt
> - 0.0.66: https://docs.refer.health.gov.sg/0-0-66/llms.txt
> - 0.0.65: https://docs.refer.health.gov.sg/0-0-65/llms.txt
> - 0.0.64: https://docs.refer.health.gov.sg/0-0-64/llms.txt
> - 0.0.63: https://docs.refer.health.gov.sg/0-0-63/llms.txt
> - 0.0.62: https://docs.refer.health.gov.sg/0-0-62/llms.txt
> - 0.0.61: https://docs.refer.health.gov.sg/0-0-61/llms.txt
> - 0.0.60: https://docs.refer.health.gov.sg/0-0-60/llms.txt
> - 0.0.59: https://docs.refer.health.gov.sg/0-0-59/llms.txt
> - 0.0.58: https://docs.refer.health.gov.sg/0-0-58/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.refer.health.gov.sg/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.refer.health.gov.sg/_mcp/server.

Learn more about the Referral Exchange APIs and discover APIs easily.

| API Endpoint Name                                                    | Category                           | Short Description                                                                                                        | Link                                                                                                                                    |
| -------------------------------------------------------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| **Subsidy and medical eligibility**                                  | Pre-Referral - Subsidy Eligibility | Checks patient’s subsidy and medical eligibility to determine which offerings they qualify for before referral creation. | [eligibility/get](../api-reference/eligibility/get)                                                                                     |
| **Retrieves a paginated list of referrals**                          | Referral Creation & Modification   | Fetches a list of referrals created by the sender, with pagination for large datasets.                                   | [referrals/list](../api-reference/referrals/list)                                                                                       |
| **Create a new referral**                                            | Referral Creation & Modification   | Creates and submits a new referral with all relevant patient and offering details.                                       | [referrals/upsert](../api-reference/referrals/upsert)                                                                                   |
| **Full details for a referral**                                      | Referral Creation & Modification   | Retrieves the complete details and metadata for a specific referral.                                                     | [referrals/get](../api-reference/referrals/get)                                                                                         |
| **Delete a draft referral**                                          | Referral Creation & Modification   | Deletes a referral that is still in draft and not yet submitted.                                                         | [referrals/delete](../api-reference/referrals/delete)                                                                                   |
| **Cancel a referral**                                                | Referral Creation & Modification   | Cancels a referral that has already been submitted but not yet confirmed.                                                | [referrals/cancel](../api-reference/referrals/cancel)                                                                                   |
| **Amend and resubmit a pending referral**                            | Referral Creation & Modification   | Allows editing of an existing referral and resubmission for processing.                                                  | [referrals/amend](../api-reference/referrals/amend)                                                                                     |
| **Accept**                                                           | Referral Offerings Listing         | Accepts a referral offer for a particular service or slot.                                                               | [referrals/accept](../api-reference/referrals/accept)                                                                                   |
| **Reject**                                                           | Referral Offerings Listing         | Rejects a referral offer with an optional reason.                                                                        | [referrals/reject](../api-reference/referrals/reject)                                                                                   |
| **Convert a referral to draft**                                      | Referral Offerings Listing         | Converts a submitted referral back into draft status for modification.                                                   | [referrals/back-to-draft](../api-reference/referrals/back-to-draft)                                                                     |
| **Create a note for a referral**                                     | Referral Details Fetching          | Adds a new note or annotation to a referral record.                                                                      | [notes/create](../api-reference/notes/create)                                                                                           |
| **List all referral destinations**                                   | Referral Details Fetching          | Returns all available destinations or institutions for referrals.                                                        | [offerings/list](../api-reference/offerings/list)                                                                                       |
| **Get the recommended offering for a category based on postal code** | Referral Details Fetching          | Suggests the most suitable referral offering based on category and patient postal code.                                  | [offerings/api-holding-controller-get-recommended-offering](../api-reference/offerings/api-holding-controller-get-recommended-offering) |
| **List 5 timeslots for a referral destination**                      | Webhooks                           | Retrieves the next five available appointment timeslots from a referral destination system.                              | [offerings/list-timeslots](../api-reference/offerings/list-timeslots)                                                                   |
| **Create a new referral link**                                       | Webhooks                           | Generates a unique referral link for email or system-based referral submissions.                                         | [links/create-upsert-link](../api-reference/links/create-upsert-link)                                                                   |
| **Fetches one referral**                                             | Referral Actions                   | Retrieves a specific referral by its unique identifier.                                                                  | [public/get-referral](../api-reference/public/get-referral)                                                                             |
| **For processing encrypted FormSG webhooks - SingHealth FormSG**     | Referral Actions                   | Handles incoming encrypted FormSG submissions for SingHealth referrals.                                                  | [webhooks/submit-sing-health-formsg](../api-reference/webhooks/submit-sing-health-formsg)                                               |
| **For processing encrypted FormSG webhooks - All Forms**             | Referral Actions                   | Processes encrypted FormSG webhook payloads for all referral form types.                                                 | [webhooks/submit-formsg](../api-reference/webhooks/submit-formsg)                                                                       |
| **Check**                                                            | Health Checks                      | Performs a simple health or connectivity check to verify that the API service is operational.                            | [health/check](../api-reference/health/check)                                                                                           |