API Overview
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. | https://docs.refer.health.gov.sg/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. | https://docs.refer.health.gov.sg/api-reference/referrals/list |
| Create a new referral | Referral Creation & Modification | Creates and submits a new referral with all relevant patient and offering details. | https://docs.refer.health.gov.sg/api-reference/referrals/upsert |
| Full details for a referral | Referral Creation & Modification | Retrieves the complete details and metadata for a specific referral. | https://docs.refer.health.gov.sg/api-reference/referrals/get |
| Delete a draft referral | Referral Creation & Modification | Deletes a referral that is still in draft and not yet submitted. | https://docs.refer.health.gov.sg/api-reference/referrals/delete |
| Cancel a referral | Referral Creation & Modification | Cancels a referral that has already been submitted but not yet confirmed. | https://docs.refer.health.gov.sg/api-reference/referrals/cancel |
| Amend and resubmit a pending referral | Referral Creation & Modification | Allows editing of an existing referral and resubmission for processing. | https://docs.refer.health.gov.sg/api-reference/referrals/amend |
| Accept | Referral Offerings Listing | Accepts a referral offer for a particular service or slot. | https://docs.refer.health.gov.sg/api-reference/referrals/accept |
| Reject | Referral Offerings Listing | Rejects a referral offer with an optional reason. | https://docs.refer.health.gov.sg/api-reference/referrals/reject |
| Convert a referral to draft | Referral Offerings Listing | Converts a submitted referral back into draft status for modification. | https://docs.refer.health.gov.sg/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. | https://docs.refer.health.gov.sg/api-reference/notes/create |
| List all referral destinations | Referral Details Fetching | Returns all available destinations or institutions for referrals. | https://docs.refer.health.gov.sg/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. | https://docs.refer.health.gov.sg/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. | https://docs.refer.health.gov.sg/api-reference/offerings/list-timeslots |
| Create a new referral link | Webhooks | Generates a unique referral link for email or system-based referral submissions. | https://docs.refer.health.gov.sg/api-reference/links/create-upsert-link |
| Fetches one referral | Referral Actions | Retrieves a specific referral by its unique identifier. | https://docs.refer.health.gov.sg/api-reference/public/get-referral |
| For processing encrypted FormSG webhooks - SingHealth FormSG | Referral Actions | Handles incoming encrypted FormSG submissions for SingHealth referrals. | https://docs.refer.health.gov.sg/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. | https://docs.refer.health.gov.sg/api-reference/webhooks/submit-formsg |
| Check | Health Checks | Performs a simple health or connectivity check to verify that the API service is operational. | https://docs.refer.health.gov.sg/api-reference/health/check |
