Organization

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/tm-forum/refs/heads/main/json-schema/tmf629-customer-management-organization-schema.json",
  "title": "Organization",
  "description": "Organization schema from TM Forum API",
  "allOf": [
    {
      "$ref": "#/components/schemas/Party"
    },
    {
      "type": "object",
      "description": "Organization represents a group of people identified by shared interests or purpose. Examples include business, department and enterprise. Because of the complex nature of many businesses, both organizations and organization units are represented by the same data.",
      "properties": {
        "isLegalEntity": {
          "type": "boolean",
          "description": "If value is true, the organization is a legal entity known by a national referential."
        },
        "isHeadOffice": {
          "type": "boolean",
          "description": "If value is true, the organization is the head office"
        },
        "organizationType": {
          "type": "string",
          "description": "Type of Organization (company, department...)"
        },
        "existsDuring": {
          "$ref": "#/components/schemas/TimePeriod"
        },
        "name": {
          "type": "string",
          "description": "Organization name (department name for example)"
        },
        "nameType": {
          "type": "string",
          "description": "Type of the name : Co, Inc, Ltd, etc."
        },
        "status": {
          "$ref": "#/components/schemas/OrganizationStateType"
        },
        "otherName": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/OtherNameOrganization"
          },
          "description": "List of additional names by which the organization is known"
        },
        "organizationIdentification": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/OrganizationIdentification"
          },
          "description": "List of official identifiers given to the organization, for example company number in the registry of companies"
        },
        "organizationChildRelationship": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/OrganizationChildRelationship"
          },
          "description": "List of organizations that are contained within this organization. For example if this organization is the Legal Department, the child organizations might include Claims, Courts, Contracts"
        },
        "organizationParentRelationship": {
          "$ref": "#/components/schemas/OrganizationParentRelationship"
        },
        "tradingName": {
          "type": "string",
          "description": "Name that the organization (unit) trades under"
        }
      }
    }
  ]
}