GET new and updated referrals

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
    }
  } ]
} ]