GET new and updated referrals

Description: Return list of all possible referral types that can be used while creating new referral.

URI

https://{server}/referrals-api/services/v1/practices/{practiceUuid}/referrals/

HTTP Method

GET

Required URI Values

Server

The domain name of the test or production system.

Test system: integration.demo.medfusion.net
Production system: integration.medfusion.net

PracticeUuid

The unique practice integration ID for a given practice. Medfusion will provide a practice ID that you can use during development.

Optional Query String Parameters

incoming

Boolean value whether to include incoming referrals (default is true)

outgoing

Boolean value whether to include outgoing referrals (default is true)

perPage

Number of records per page (max is 100, default is 100)

page

Page number

sinceCreatedTime

Return only records that were created after this time (default all time)

sinceUpdatedTime

Return only records that were updated after this time (default all time)

Success Response

200 – Success with referral types listed in response
400 – Bad request
401 – Unauthorized request

Sample Call

HTTP Request

GET https://integration.medfusion.net/referrals-api/services/v1/practices/12345678-1234-1234-1234-1234567890ab/referral-api

Header

•	Authorization: Bearer {OAuth token}
•	ExternalSystemId: {External System ID}

Body: No body is supplied

Sample Response

Response Header

Transfer-Encoding: chunked
Content-Type: application/json
Connection: Keep-Alive
Keep-Alive: timeout=5, max=100

Response Body

[ {
  "uuid" : "dbd02589-e442-45de-9fe7-5ceb5b401bf4",
  "status" : "Viewed",
  "sender" : {
    "actorType" : "externalStaff",
    "practiceUuid" : "7b0ee60d-202f-4689-92dc-94e406325f44",
    "practiceName" : "Golem Group from GW template",
    "staffUuid" : "1aa754e2-3ee0-4838-94bb-48fd42121786",
    "firstName" : "PhysGWTemp1",
    "lastName" : "StaffMember1",
    "externalStaffId" : null
  },
  "recipient" : {
    "actorType" : "practice",
    "practiceUuid" : "a76299d8-2576-4b68-bd8c-5893ca46693f",
    "practiceName" : "GolemGroup"
  },
  "patient" : {
    "externalPatientId" : null,
    "firstName" : "Golem_Dev3_Pat1",
    "lastName" : "TestPatient1",
    "gender" : "M",
    "dob" : "2000-09-10",
    "phones" : [ {
      "type" : "Home",
      "number" : "(919) 882-0178",
      "preferred" : false
    }, {
      "type" : "Mobil",
      "number" : "(123) 456-7890",
      "preferred" : false
    } ]
  },
  "referralTypeName" : "Post ER",
  "reason" : null,
  "additionalInformation" : null,
  "createdTime" : "2016-02-01T15:10:09.618+0000",
  "lastUpdatedTime" : "2016-07-11T18:31:19.397+0000",
  "direction" : "outgoing",
  "comments" : [ {
    "uuid" : "6f449cdb-2ae1-4ae4-8097-c500f37242c0",
    "createdTime" : "2016-02-01T15:11:57.441+0000",
    "createdBy" : {
      "actorType" : "staff",
      "practiceUuid" : "a76299d8-2576-4b68-bd8c-5893ca46693f",
      "practiceName" : "GolemGroup",
      "staffUuid" : "96bdd90c-f5f9-4a49-8fe8-dfcaaff50fa6",
      "firstName" : "PhysGG1",
      "lastName" : "StaffMember1"
    },
    "text" : "test comm"
  } ],
  "attachments" : [ {
    "uuid" : "1c6806b8-9280-491c-aed0-abc23dc04eab",
    "name" : "APIs.docx",
    "createdTime" : "2016-07-11T18:31:19.239+0000",
    "createdBy" : {
      "actorType" : "staff",
      "practiceUuid" : "a76299d8-2576-4b68-bd8c-5893ca46693f",
      "practiceName" : "GolemGroup",
      "staffUuid" : "96bdd90c-f5f9-4a49-8fe8-dfcaaff50fa6",
      "firstName" : "PhysGG1",
      "lastName" : "StaffMember1"
    }
  } ]
}, {
  "uuid" : "50b53d23-323e-4636-bf6d-aedf7ba99c31",
  "status" : "Viewed",
  "sender" : {
    "actorType" : "staff",
    "practiceUuid" : "a76299d8-2576-4b68-bd8c-5893ca46693f",
    "practiceName" : "GolemGroup",
    "staffUuid" : "96bdd90c-f5f9-4a49-8fe8-dfcaaff50fa6",
    "firstName" : "PhysGG1",
    "lastName" : "StaffMember1"
  },
  "recipient" : {
    "actorType" : "practice",
    "practiceUuid" : "7b0ee60d-202f-4689-92dc-94e406325f44",
    "practiceName" : "Golem Group from GW template"
  },
  "patient" : {
    "externalPatientId" : null,
    "firstName" : "Golem_Dev3_Pat1",
    "lastName" : "TestPatient1",
    "gender" : "M",
    "dob" : "2000-09-10",
    "phones" : [ {
      "type" : "Home",
      "number" : "9198820171",
      "preferred" : true
    }, {
      "type" : "Mobil",
      "number" : "1234567891",
      "preferred" : false
    } ]
  },
  "referralTypeName" : "Care Management",
  "reason" : "greg4ae",
  "additionalInformation" : "graergrgr",
  "createdTime" : "2016-07-26T11:52:46.046+0000",
  "lastUpdatedTime" : "2016-10-19T18:43:12.273+0000",
  "direction" : "incoming",
  "comments" : [ {
    "uuid" : "4de7ee12-d1e9-48c5-9a5e-977df225bf03",
    "createdTime" : "2016-10-19T18:43:11.848+0000",
    "createdBy" : {
      "actorType" : "externalStaff",
      "practiceUuid" : "7b0ee60d-202f-4689-92dc-94e406325f44",
      "practiceName" : "Golem Group from GW template",
      "staffUuid" : "1aa754e2-3ee0-4838-94bb-48fd42121786",
      "firstName" : "PhysGWTemp1",
      "lastName" : "StaffMember1",
      "externalStaffId" : null
    },
    "text" : "Testing comment"
  } ],
  "attachments" : [ {
    "uuid" : "618c728c-5e14-4b6a-a8fc-a30623346fcc",
    "name" : "CCD Sample.pdf",
    "createdTime" : "2016-10-19T18:43:12.222+0000",
    "createdBy" : {
      "actorType" : "externalStaff",
      "practiceUuid" : "7b0ee60d-202f-4689-92dc-94e406325f44",
      "practiceName" : "Golem Group from GW template",
      "staffUuid" : "1aa754e2-3ee0-4838-94bb-48fd42121786",
      "firstName" : "PhysGWTemp1",
      "lastName" : "StaffMember1",
      "externalStaffId" : null
    }
  } ]
} ]

←

→