> This page is for version 0.0.65. > 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. Every referral in RefX progresses through a set of defined statuses, representing its current position in the referral journey. ## Status filters vs status values RefX exposes two related status concepts: * **Status (returned by `Get full details for a referral`):** a detailed status that reflects the current step. * **Status filter (used by `Retrieves a paginated list of referrals`):** a stable, high-level category used for querying (`draft`, `pending`, `confirmed`, `rejected`, `cancelled`). Use the status filter values when calling the `Retrieves a paginated list of referrals` and `Retrieves a paginated list of referrals by institution` endpoints, and use the detailed status values returned by the Get endpoint to drive finer-grained UI states or actions. ## Status filter mapping and meanings | Status filter (Retrieves a paginated list of referrals) | Status value (Get full details for a referral) | Description | | ------------------------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `draft` | `draft` | Referral is created but not yet submitted. Can be edited or deleted. | | `pending` | `created` | Referral is submitted and queued for processing. | | `pending` | `pending-singhealth-formsg` | The patient is required to provide details via a SingHealth FormSG form as they have been identified as new to SingHealth, required for first-time visits. An SMS has been triggered to the patient. Alternatively, the referral sender can fill this up on the patient's behalf too. This status remains as such until action either by the patient or referral sender has been taken. | | `pending` | `pending-singhealth-call-centre` | Waiting for the SingHealth call centre to act on the referral. | | `pending` | `referral-confirmed-pending-appt` | Referral confirmed, awaiting appointment scheduling. | | `pending` | `pending-email-ack` | Waiting for acknowledgement of the referral. | | `pending` | `pending-amend-timeslot` | The previously selected timeslot is no longer available, and hence another timeslot needs to be re-selected. | | `confirmed` | `confirmed` | Referral is confirmed. | | `confirmed` | `sent` | Information email has been sent; no further action required. | | `rejected` | `rejected` | Rejected by validation logic or by the receiving system. | | `rejected` | `failed` | Processing failed and the referral will not proceed. | | `cancelled` | `pending-cancelled` | Cancellation requested and awaiting completion. | | `cancelled` | `cancelled` | Referral cancelled by sender, receiver, or administrator. | ## Action-required statuses and links Some detailed statuses require action by the API consumer (for example, your UI should prompt the user to complete a step). To receive action links, call **Get Full details for a referral** with `additionalField=link` in the query string. The response includes a `links` array with the action URLs. | Status value (Get full details for a referral) | Action needed | Link type returned | | ---------------------------------------------- | ------------------------------------------------- | ------------------------ | | `draft` | Complete or amend the referral before submission. | `amend` | | `pending-amend-timeslot` | Reselect an appointment timeslot. | `select-timeslot` | | `pending-singhealth-formsg` | Complete the SingHealth FormSG form. | `fill-singhealth-formsg` | Not all systems handle every state transition. For instance, some integrations automatically confirm referrals upon submission, while others may wait for manual scheduling or validation by the receiver. When building your integration, plan for status changes to occur asynchronously and always treat the referral status as the source of truth.