Organization (ARKO)

ArkID Organization Schema

Defines ArkID master records for organisations, mapping legal identity, locations, governance, and cross-identifier references.

Version

1.2.0

Last Updated

2025-06-15

Alignment

ArkID organisation master data + EC PIC alignment

Source Schema

docs/schemas/arkid_organization_schema.json

Highlights

  • Enforces ArkID identifier (`arkidOrg`) and optional PIC numbers sourced from the reference catalogue.
  • Captures location data (city, country, address details) for geospatial analysis.
  • Supports governance relationships through managedBy and associatedArkIds arrays.

When to Use

  • Onboarding organisations into ArkID before project allocation.
  • Maintaining a single source of truth for organisational identifiers across integrations.
  • Powering UI directory listings and Keycloak realm syncs.

Organisation Identity

Core master-data representation.

arkidOrg

string (ARKO identifier)Optional

Generated ArkID value once the organisation is verified.

organizationDetails.organizationName

stringRequired

Legal name used in contracts.

organizationDetails.organizationAcronym

stringRecommended

Short display name for dashboards.

organizationDetails.organizationType

string (enum)Required

Organisation category aligned with the reference catalogue.

Location & Contact

Data used for RIS reporting and outreach.

organizationLocation.city / country

stringRequired

City and ISO country code for the headquarters.

organizationLocation.coordinates

objectOptional

Latitude/longitude when available for mapping.

contactPoints[]

arrayOptional

Named contacts with email/phone for partnership outreach.

Identifier Links

External identifiers to support interoperability.

  • identifiers.pic stores the EC Participant Identification Code and validates via the reference catalogue.
  • identifiers.ror, identifiers.grid, and identifiers.isni allow mapping to external registries.
  • associatedEntities captures ARKP, ARKD, and ARKI references for quick graph traversal.

Organisation master record

{
  "arkidOrg": "ARKO-2024-0001-0002-0001",
  "organization": {
    "name": "Health Tech Europe GmbH",
    "acronym": "HTE",
    "type": "Research Institution"
  },
  "location": {
    "city": "Berlin",
    "country": "DE"
  },
  "managedBy": "ARKU-2024-0001-0002-0001"
}