Party Kernel & Polymorphic Directory

The core business directory managing people, organizations, contact points, relationships, and data merge candidates.

Primary API Endpoints

PartyKernel C1 API contractHTTP
# Create a Person and its Party identity in one request.
# Requires parties.create and party-people.create.
POST /api/v1/Parties/people
Authorization: Bearer <access-token>
Idempotency-Key: <stable-request-key>
Content-Type: application/json

{
  "fullName": "ندى",
  "displayName": "ندى",
  "givenName": null,
  "middleNames": null,
  "familyName": null
}

# Create an Organization and its Party identity in one request.
# Requires parties.create and party-organizations.create.
POST /api/v1/Parties/organizations
Authorization: Bearer <access-token>
Idempotency-Key: <stable-request-key>
Content-Type: application/json

{
  "legalName": "Northwind Sporting Ltd.",
  "displayName": "Northwind"
}

# Read a safe typed profile or tenant-scoped selector results.
# Profile requires parties.view plus the matching subtype .view permission.
GET /api/v1/Parties/{encryptedPartyId}/profile
GET /api/v1/Parties/people/lookup?page=1&pageSize=20&search=...
GET /api/v1/Parties/organizations/lookup?page=1&pageSize=20&search=...