Create Registration

This API is available for Registering a participant

Below are the attributes which needs to be send along with the request body:

Parameter

Details

participant

Details of the participant which is being registered.

Paramter	Details
id	Identifier of the participant being registered. Specify the identifier, if it already exists.
firstName	First name of the participant
middleName	Middle name of the participant
lastName	Last name of the participant
uid	Unique identifier of participant e.g Social Security Number
birthDate	date of birth of participant
vitalStatus	Vital status of the participant.
deathDate	date of death participant
gender	gender of the participant, permissible values are {Male Gender, Female Gender, Unknown, Unspecified}
race	Patient's racial origination, permissible values are: {American Indian or Alaska Native, Asian, Black or African American, Native Hawaiian or other Pacific Islander, Not Reported, Unknown, White}
ethnicity	Patient's ethnicity status. permissible values are: {Hispanic or Latino, Not Hispanic or Latino, Not Reported, Unknown}
sexGenotype	The genetic constitution of the individual; the characterization of the genes. Permissible values are: {XX Genotype, XY Genotype, XXX, Klinefelter’s Syndrome, XXXY syndrome, XXYY syndrome, Mosaic including XXXXY, Penta X syndrome}
pmis	collection of Participant's medical record number used in their medical treatment.
mrn	Participant's medical record number used in their medical treatment.
siteName	Name of the physical location.
empi	Any other unique identifier for patient, like enterprise master patient index number

cpId

Identifier of the protocol to which the participant is being registered.

cpTitle

Title of the protocol to which the participant is being registered.

cpShortTitle

ShortTitle of the protocol to which the participant is being registered.

ppid

Protocol Participant Identifier, this is the identifier to uniquely identify the participant with in a protocol.

Note: If PPID is set to auto-generated at protocol level, then please leave this attribute blank.

registrationDate

Date of the registration of participant

URL	openspecimen/rest/ng/collection-protocol-registrations
Request type	application/json
Method	POST
json	{ "participantDetail":{ "id":2 }, "cpId":1, "ppid":"ASCI123", "activityStatus":"Active", "registrationDate":"2014-04-21" }
Response	{ "id":5, "participantDetail":{ "id":2 }, "cpId":1, "ppid":"ASCI123", "activityStatus":"Active", "registrationDate":"2014-04-21" }

Error Cases :

code	Applies to	Status Message
200	All resources	Participant registered successfully
400	All requests	Invalid parameters, e.g duplicate UID, duplicate PPID etc
401	All requests	Authorization failed, User doesn’t have Authority to register Participant for the given collection protocol
500	All requests	Internal server error, Encountered server error while performing operations