Versions Compared

Old Version 20

changes.mady.by.user Noah Carnahan

Saved on

compared with

New Version 21

changes.mady.by.user Former user

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Purpose: get all of the data associated with a case, including all case property values, a list of associated forms and a list of associated referrals. The case data may be presented to the end user as a case details screen.

Base URL: https://www.commcarehq.org/a/[domain]/api/[version]/case/[case_id]/

Authentication: For more information, please review CommCare's API Authentication Documentation.

Input parameters:

NameDescriptionValuesExampleStatus
formatReturn data format

xml, json

format=xmlSupported

properties

Whether to include properties

all, none

properties=allProposed
indicesWhether to include indicesall, noneindices=allProposed
xforms_by_name__fullWhether to include all xforms by nametruexforms_by_name__full=trueSupported
xforms_by_xmls__fullWhether to include all xforms by xmlnstruexforms_by_xmlns__full=trueSupported
child_cases__fullWhether to include child casestruechild_cases__full=trueSupported since version 4
parent_cases__fullWhether to include parent casestrueparent_cases__full=trueSupported since version 4

Output values: 

NameDescriptionExample
case_idCase UUID0X9OCW3JMV98EYOVN32SGN4II
user_nameUser name of case owner, including domainjdoe@example.commcarehq.org
user_idUUID of user that owns the case3c5a623af057e23a32ae4000cf291339
date_modifiedDate and time case was last modified2011-12-13T15:09:47Z
closedStatus of the case (open, closed)false
date_closedDate and time case was closed2011-12-20T15:09:47Z
propertiesList of all editable case properties, including both special predefined properties and user-defined dynamic properties
Special Properties
owner_idID of the owner of the case (can be user or group)
case_nameName of caseRose
external_idExternal ID associated with the case123456
case_typeType of casepregnancy
date_openedDate and time case was opened2011-11-16T14:26:15Z
End Special Properties
indicesList of references to other cases with properties <case_type/> and <case_id/>
Start of data from for each form associated with the case
Repeats for each form, as seen in sample output below
form_idUUID of form associated with the case1J9NF7B4FTH73435PYJJSL5SJ
form_nameName of form associated with the casePrenatal visit
started_onDate and time form was started2011-11-16T14:26:15Z
ended_onDate and time form was completed2011-11-16T14:27:35Z

...


Sample usage:

Code Block
https://www.commcarehq.org/a/demo/api/v0.4/case/0X9OCW3JMV98EYOVN32SGN4II/?format=xml&properties=all&indices=all

...

Code Block
languagehtml/xml
<case>
	<domain>example</domain>
	<case_id>0X9OCW3JMV98EYOVN32SGN4II</case_id>
	<username>jdoe@example.commcarehq.org</user_name>
	<user_id>3c5a623af057e23a32ae4000cf291339</user_id>
	<closed>false</closed>
	<date_closed>2011-12-20 15:09:47Z</date_closed>
	<date_modified>2011-12-13 15:09:47Z</date_modified>
	<properties>
		<case_name>Rose</case_name>
		<case_type>pregnancy</case_type>
		<date_opened>2011-11-16T14:26:15Z</date_opened>
		<external_id>123456</external_id>
		<owner_id>3c5a623af057e23a32ae4000cf291339</owner_id>
		<case_property1>Dynamic property value 1</case_property1>
		<case_property2>Dynamic property value 2</case_property2>
		...
	</properties>
	<indices>
		<case_ref1>
			<case_type>other_case_type</case_type>
			<case_id>8GPM05TVPIUH0Q4XLXVIURRTA</case_id>
		</case_ref1>
		...
	</indices>
	<forms>
		<form>
			<form_id>1J9NF7B4FTH73435PYJJSL5SJ</form_id>
			<form_name>Prenatal visit</form_name>
			<started_on>2011-11-16T14:26:15Z</started_on>
			<ended_on>2011-11-16T14:27:35Z</ended_on>
			<properties>
				<form_property1>Dynamic property value 1</form_property1>
				<form_property2>Dynamic property value 2</form_property2>
				...
			</properties>
		</form>
		...
	</forms>
	<referrals>
		<referral>
			<referral_id>D8LZS28LEUWU7W9QNDM89XWPL</referral_id>
			<referral_type>referred_to_health_center</referral_type>
			<opened_on>2011-11-17T14:26:15Z</opened_on>
			<modified_on>2011-11-17T14:27:10Z</modified_on>
			<followup_on>2011-11-19T00:00:00Z</followup_on>
			<referral_status>open</referral_status>
		</referral>
		...
	<referrals>
	...
</case>

 

 

...