Referral Workflow

SDOH referrals are created on the One Degree platform (1degree.org) and surfaced to your organization as Task resources via the INTERLINK API. Your integration retrieves Tasks and updates their status as work progresses.

Referrals follow the Gravity Project SDOH Clinical Care IG, specifically the TaskForReferralManagement profile.

Flow

API Operations

Retrieve a Task by ID

GET /fhir/{tenantPartition}/Task/{id}
Authorization: Bearer {token}

Search Tasks by status

Retrieve all Tasks with a given status (see Task status values below):

GET /fhir/{tenantPartition}/Task?status=requested
Authorization: Bearer {token}

Retrieve Tasks with a given status that have been updated since a given date:

GET /fhir/{tenantPartition}/Task?status=requested&_lastUpdated=gt2026-05-15T00:00:00Z
Authorization: Bearer {token}

Results are returned as a FHIR Bundle. Use _count to control page size and follow the next link in the Bundle for subsequent pages:

GET /fhir/{tenantPartition}/Task?status=requested&_count=20
Authorization: Bearer {token}

Update Task status

Use a FHIRPath PATCH to update the Task status. Only Task.status updates are supported.

PATCH /fhir/{tenantPartition}/Task/{id}
Content-Type: application/fhir+json
Authorization: Bearer {token}

{
  "resourceType": "Parameters",
  "parameter": [{
    "name": "operation",
    "part": [
      { "name": "type",  "valueCode": "replace" },
      { "name": "path",  "valueString": "Task.status" },
      { "name": "value", "valueCode": "accepted" }
    ]
  }]
}

Task status values

See also the Gravity IG status management guidance for recommended status transitions.

Status	Meaning
requested	Referral created on One Degree, awaiting acceptance
accepted	Task accepted by your organization
rejected	Task declined by your organization
in-progress	Referral being actively worked on
on-hold	Work paused, e.g. awaiting client response
completed	Referral fulfilled
cancelled	Referral cancelled
failed	Referral could not be fulfilled

FHIR Subscriptions

As part of enabling your integration, INTERLINK will work with you to configure FHIR Subscriptions for your tenant. Subscriptions allow One Degree to notify your system in real time when resources relevant to your organization are created or updated, such as when a new referral Task is assigned to you.

Subscription configuration is handled during the integration onboarding process. Contact INTERLINK support to get started.