Skip to Main Content

R4 APIs (Millennium)

Announcement

For information related to the Oracle Partner Network (OPN) Industry Healthcare Track please visit our OPN Industry Healthcare Program page.

For specific questions related to Oracle Partner Network (OPN), please contact Partner Assistance.

Millennium FHIR and non-FHIR API Specifications and Supporting Documents can be found HERE on docs.oracle.com
Soarian FHIR API Specifications and Supporting Documents can be found HERE on docs.oracle.com.

Patient Create

Kevin FlynnDec 30 2025 — edited Dec 30 2025

Workflow or API calls:

Reminder: If this is referring to a client domain or EHR activity—not the public sandbox—do not include API request data or live patient data.

Background Information:

Failure to provide answers will impact our ability to respond in a timely and effective manner
Developer questions:

Is there a way to perform a conditional Patient Create API call, such that if a patient exists with matching demographic information, the FHIR server will return the existing Patient rather than creating a new one?

Looking at the API doc for the “Create a Patient” endpoint here: https://docs.oracle.com/en/industries/health/millennium-platform-apis/mfrap/op-patient-post.html - I don't see any mention of the “If-None-Exist” or “If-Match” Headers.

Additionally - what is the expected format for the “identifier” field, to specify a Social Security Number for a Patient?

I am providing this payload to the “Create a Patient” endpoint, but getting a 400 Bad Request response back.

{
	"resourceType": "Patient",
	"identifier": [
		{
			"assigner": {
				"reference": "Organization/675844"
			}
		},
		{
			"type": {
				"coding": [
					{
						"system": "http://hl7.org/fhir/sid/us-ssn",
						"code": "SSN"
					}
				]
			},
			"system": "urn:oid:2.16.840.1.113883.4.1",
			"value": "111223333"
		}
	],
	"name": [
		{
			"use": "official",
			"family": "Tester",
			"given": [
				"Patient",
				"Create"
			]
		}
	],
	"telecom": [
		{
			"system": "phone",
			"value": "281-330-8004",
			"use": "home"
		}
	],
	"gender": "male",
	"birthDate": "1981-11-18"
}

Are you an OPN Member? Yes
Have you signed up to be in the Healthcare Developer Track? Yes
Are you a registered Code Program member? Not sure
Does your App have a presence on the Oracle Healthcare App Marketplace? No

Are you developing on behalf of an Oracle Health client? No
If so, which client:

Application's Client ID and App ID, if relevant:

Application ID

46c572a8-378b-4b18-8c3b-aff04757dda3

Client ID

9351201f-aba3-4674-9dd3-30e4fb8ab98d

Expected Result: 201 Created response code

Actual Result: 400 Bad Request response code

{
	"resourceType": "OperationOutcome",
	"issue": [
		{
			"severity": "error",
			"code": "invalid",
			"details": {
				"text": "Invalid request"
			}
		}
	]
}

X-Request-Id: /4FD8DE026EE956305FEB5D8FF5E59A25+RRRN_KVP9

opc-request-id: /4FD8DE026EE956305FEB5D8FF5E59A25/F45406ADF0A4D885456DCFB5669D8718
Date/time of the example: Tue, 30 Dec 2025 18:02:00 GMT

Comments
Post Details
Added on Dec 30 2025
1 comment
61 views