How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Cadasto Demographic API

The openEHR ITS-REST Demographic API: create, read, update and delete PERSON, ORGANISATION, ROLE, AGENT and GROUP parties, read versioned parties and their revision history, create demographic CONTRIBUTIONs, and manage ITEM_TAGs on every party type. 42 operations. Demographic data is versioned and stored separately from clinical content by design.

This API exposes 42 operations across 27 paths, organized into 8 resource areas, and defines 105 schemas. It is described by OpenAPI 3.1.1, at version development.

Requests are made against a single base URL, https://{baseUrl}/v1.

42 operations 27 paths 105 schemas 10 DELETE16 GET6 POST10 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.1
API Version
development
Base URL
https://{mycompany}.api.prod.cadasto.io/openehr/v1
Resource Areas
8

Paths & Operations 42

Across 27 paths, the API surfaces 42 operations — 10 DELETE, 16 GET, 6 POST, 10 PUT. They span 8 resource areas: AGENT, GROUP, ORGANISATION, PERSON, ROLE, VERSIONED_PARTY, CONTRIBUTION, ITEM_TAG. Each is listed below with its method, path, parameters, and response codes.

AGENT 4

Management of the [AGENT](https://specifications.openehr.org/releases/RM/latest/demographic.htmlagentclass) class.

POST
/demographic/agent
Create AGENT
agent_create 2 params body → 201400404422
GET
/demographic/agent/{uid_based_id}
Get AGENT
agent_get 3 params → 200204404
PUT
/demographic/agent/{uid_based_id}
Update AGENT
agent_update 4 params body → 200204400404412422
DELETE
/demographic/agent/{uid_based_id}
Delete AGENT
agent_delete 1 param → 204400404409
GROUP 4

Management of the [GROUP](https://specifications.openehr.org/releases/RM/latest/demographic.htmlgroupclass) class.

POST
/demographic/group
Create GROUP
group_create 2 params body → 201400404422
GET
/demographic/group/{uid_based_id}
Get GROUP
group_get 3 params → 200204404
PUT
/demographic/group/{uid_based_id}
Update GROUP
group_update 4 params body → 200204400404412422
DELETE
/demographic/group/{uid_based_id}
Delete GROUP
group_delete 1 param → 204400404409
ORGANISATION 4

Management of the [ORGANISATION](https://specifications.openehr.org/releases/RM/latest/demographic.htmlorganisationclass) class.

POST
/demographic/organisation
Create ORGANISATION
organisation_create 2 params body → 201400404422
GET
/demographic/organisation/{uid_based_id}
Get ORGANISATION
organisation_get 3 params → 200204404
PUT
/demographic/organisation/{uid_based_id}
Update ORGANISATION
organisation_update 4 params body → 200204400404412422
DELETE
/demographic/organisation/{uid_based_id}
Delete ORGANISATION
organisation_delete 1 param → 204400404409
PERSON 4

Management of the [PERSON](https://specifications.openehr.org/releases/RM/latest/demographic.htmlpersonclass) class.

POST
/demographic/person
Create PERSON
person_create 2 params body → 201400404422
GET
/demographic/person/{uid_based_id}
Get PERSON
person_get 3 params → 200204404
PUT
/demographic/person/{uid_based_id}
Update PERSON
person_update 4 params body → 200204400404412422
DELETE
/demographic/person/{uid_based_id}
Delete PERSON
person_delete 1 param → 204400404409
ROLE 4

Management of the [ROLE](https://specifications.openehr.org/releases/RM/latest/demographic.htmlroleclass) class.

POST
/demographic/role
Create ROLE
role_create 2 params body → 201400404422
GET
/demographic/role/{uid_based_id}
Get ROLE
role_get 3 params → 200204404
PUT
/demographic/role/{uid_based_id}
Update ROLE
role_update 4 params body → 200204400404412422
DELETE
/demographic/role/{uid_based_id}
Delete ROLE
role_delete 1 param → 204400404409
VERSIONED_PARTY 4

Management of the [VERSIONEDPARTY](https://specifications.openehr.org/releases/RM/latest/demographic.htmlversionedpartyclass) class.

GET
/demographic/versioned_party/{versioned_object_uid}
Get VERSIONEDPARTY
versioned_party_get 1 param → 200404
GET
/demographic/versioned_party/{versioned_object_uid}/revision_history
Get VERSIONEDPARTY revision history
versioned_party_revision_history 1 param → 200404
GET
/demographic/versioned_party/{versioned_object_uid}/version
Get VERSIONEDPARTY version at time
versioned_party_version_get_at_time 2 params → 200404
GET
/demographic/versioned_party/{versioned_object_uid}/version/{version_uid}
Get VERSIONEDPARTY version by id
versioned_party_version_get_by_id 2 params → 200404
CONTRIBUTION 2

Management of [CONTRIBUTION](https://specifications.openehr.org/releases/RM/latest/common.htmlcontributionclass) class.

POST
/demographic/contribution
Create CONTRIBUTION
contribution_create 1 param body → 201400409
GET
/demographic/contribution/{contribution_uid}
Get CONTRIBUTION by id
contribution_get 1 param → 200404
ITEM_TAG 16

Management of [ITEMTAG](https://specifications.openehr.org/releases/RM/latest/common.htmlitemtagclass) resources attached to demographic versioned objects (PERSON, AGENT, GROUP, O…

GET
/demographic/tags
Get demographic tags
demographic_tags_get 3 params → 200400
GET
/demographic/agent/{uid_based_id}/tags
Get AGENT tags
agent_tags_get 1 param → 200404
PUT
/demographic/agent/{uid_based_id}/tags
Update AGENT tags
agent_tags_update 2 params body → 200204400404
DELETE
/demographic/agent/{uid_based_id}/tags/{key}
Delete AGENT tag by key
agent_tags_delete 2 params → 204404
GET
/demographic/group/{uid_based_id}/tags
Get GROUP tags
group_tags_get 1 param → 200404
PUT
/demographic/group/{uid_based_id}/tags
Update GROUP tags
group_tags_update 2 params body → 200204400404
DELETE
/demographic/group/{uid_based_id}/tags/{key}
Delete GROUP tag by key
group_tags_delete 2 params → 204404
GET
/demographic/organisation/{uid_based_id}/tags
Get ORGANISATION tags
organisation_tags_get 1 param → 200404
PUT
/demographic/organisation/{uid_based_id}/tags
Update ORGANISATION tags
organisation_tags_update 2 params body → 200204400404
DELETE
/demographic/organisation/{uid_based_id}/tags/{key}
Delete ORGANISATION tag by key
organisation_tags_delete 2 params → 204404
GET
/demographic/person/{uid_based_id}/tags
Get PERSON tags
person_tags_get 1 param → 200404
PUT
/demographic/person/{uid_based_id}/tags
Update PERSON tags
person_tags_update 2 params body → 200204400404
DELETE
/demographic/person/{uid_based_id}/tags/{key}
Delete PERSON tag by key
person_tags_delete 2 params → 204404
GET
/demographic/role/{uid_based_id}/tags
Get ROLE tags
role_tags_get 1 param → 200404
PUT
/demographic/role/{uid_based_id}/tags
Update ROLE tags
role_tags_update 2 params body → 200204400404
DELETE
/demographic/role/{uid_based_id}/tags/{key}
Delete ROLE tag by key
role_tags_delete 2 params → 204404

Schemas 105

The contract defines 105 schemas that model the data the API accepts and returns. The most detailed are UMRole (14 properties), Role (14 properties), Person (13 properties), Group (13 properties). Each schema is shown below with its type and property counts.

UMDvUri
object
2 properties 2 required
DvEhrUri
object
2 properties 1 required
UMDvEhrUri
object
2 properties 2 required
UDvUri
object
Polymorphic DVURI wrapper. See concrete leaf schemas: - UMDvUri - UMDvEhrUri
TerminologyId
object
2 properties 1 required
CodePhrase
object
3 properties 2 required
DvCodedText
object
8 properties 2 required
TermMapping
object
3 properties 2 required
UMDvText
object
7 properties 2 required
UMDvCodedText
object
8 properties 3 required
UDvText
object
Polymorphic DVTEXT wrapper. See concrete leaf schemas: - UMDvText - UMDvCodedText
HierObjectId
object
2 properties 1 required
UMHierObjectId
object
2 properties 2 required
ObjectVersionId
object
2 properties 1 required
UMObjectVersionId
object
2 properties 2 required
UUidBasedId
object
Link
object
3 properties 3 required
ArchetypeId
object
2 properties 1 required
TemplateId
object
2 properties 1 required
Archetyped
object
3 properties 2 required
DvIdentifier
object
Type for representing identifiers of real-world entities. Typical identifiers include drivers licence number, social security number, veterans affairs number,…
5 properties 1 required
DvMultimedia
object
12 properties 3 required
UMDvMultimedia
object
12 properties 3 required
UMDvParsable
object
5 properties 3 required
UDvEncapsulated
object
Polymorphic DVENCAPSULATED wrapper. See concrete leaf schemas: - UMDvMultimedia - UMDvParsable
PartyRef
object
Identifier for parties in a demographic or identity service.
3 properties 3 required
UMPartyIdentified
object
4 properties 1 required
UMPartyRelated
object
5 properties 2 required
UPartyIdentified
object
Polymorphic PARTYIDENTIFIED wrapper. See concrete leaf schemas: - UMPartyIdentified - UMPartyRelated
UMPartySelf
object
2 properties 1 required
UPartyProxy
object
Polymorphic PARTYPROXY wrapper. See concrete leaf schemas: - UMPartySelf - UMPartyIdentified - UMPartyRelated
DvInterval
object
5 properties 4 required
ReferenceRange
object
2 properties 2 required
DvDuration
object
7 properties
DvDateTime
object
7 properties 1 required
UMDvBoolean
object
2 properties 2 required
UMDvCount
object
8 properties 2 required
UMDvDate
object
7 properties 2 required
UMDvDateTime
object
7 properties 2 required
UMDvDuration
object
7 properties 1 required
UMDvIdentifier
object
5 properties 2 required
UMDvOrdinal
object
6 properties 3 required
UMDvProportion
object
11 properties 4 required
UMDvQuantity
object
12 properties 3 required
UMDvScale
object
6 properties 3 required
UMDvState
object
3 properties 3 required
UMDvTime
object
7 properties 2 required
UDataValue
object
Element
object
10 properties 2 required
ItemSingle
object
8 properties 3 required
ItemList
object
8 properties 2 required
Clstr
object
8 properties 3 required
UItem
object
Polymorphic ITEM wrapper. See concrete leaf schemas: - Element - Clstr (CLUSTER)
UItemLeaf
object
ItemTable
object
8 properties 2 required
ItemTree
object
8 properties 2 required
UItemStructure
object
Polymorphic ITEMSTRUCTURE wrapper. See concrete leaf schemas: - ItemSingle - ItemList - ItemTable - ItemTree
FeederAuditDetails
object
7 properties 1 required
FeederAudit
object
5 properties 1 required
PartyIdentity
object
8 properties 3 required
ListOfPartyIdentity
array
Address
object
8 properties 3 required
DvIntervalOfDate
object
7 properties 4 required
Contact
object
9 properties 3 required
ListOfContact
array
PartyRelationship
object
11 properties 4 required
ListOfPartyRelationship
array
Agent
object
13 properties 3 required
Identifier
object
1 property 1 required
Error
object
2 properties 2 required
Group
object
13 properties 3 required
Organisation
object
13 properties 3 required
Person
object
13 properties 3 required
Capability
object
9 properties 3 required
ListOfCapability
array
Role
object
14 properties 4 required
ObjectRefOfHierObjectId
object
3 properties 3 required
VersionedParty
object
A VERSIONEDPARTY resource
4 properties 3 required
AuditDetails
object
The set of attributes required to document the committal of an information item to a repository.
6 properties 4 required
RevisionHistoryItem
object
A REVISIONHISTORYITEM resource
2 properties 2 required
RevisionHistory
object
A REVISIONHISTORY resource
1 property 1 required
UMAgent
object
13 properties 4 required
UMGroup
object
13 properties 4 required
UMOrganisation
object
13 properties 4 required
UMPerson
object
13 properties 4 required
UMRole
object
14 properties 5 required
UVersionable
object
Abstract parent of AGENT, GROUP, ORGANISATION, PERSON, ROLE. (Simplified for Docs)
Attestation
object
11 properties 6 required
UParty
object
UMOriginalVersionOfParty
object
10 properties 6 required
UMImportedVersionOfParty
object
6 properties 5 required
UVersionOfParty
object
TerminologyCode
object
4 properties 2 required
UpdateAudit
object
The set of attributes required to document the committal of an information item to a repository. Used by the server to create an AUDITDETAILS object.
4 properties 2 required
UpdateAttestation
object
9 properties 4 required
UpdateVersion
object
6 properties 3 required
NewContribution
object
A new (un-committed) CONTRIBUTION resource for Demographic
3 properties 2 required
ObjectRefOfObjectVersionId
object
3 properties 3 required
Contribution
object
A CONTRIBUTION resource
3 properties 3 required
UpdateItemTag
object
3 properties 1 required
ItemTagOfPerson
object
5 properties 3 required
ItemTagOfAgent
object
5 properties 3 required
ItemTagOfGroup
object
5 properties 3 required
ItemTagOfOrganisation
object
5 properties 3 required
ItemTagOfRole
object
5 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

cadasto-demographic-api-openapi.json Raw ↑
Where this information came from

This is an independent, third-party profile of Cadasto Demographic API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.