Organization Object

A formally structured entity such as a company, non-profit, school, or club.

Modeled based on https://schema.org/Organization

We welcome your feedback. Please use the Improvement Requests form.

Organization Object JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://apis.objectsgrid.com/schemas/OGObject.schema.json",
  "title": "Organization",
  "description": "Objects Grid Organization Object",
  "type": "object",
  "properties": {
    "at_context": {
      "description": "Schema context",
      "type": ["string", "null"],
      "enum": ["https://schema.org"]
    },
    "at_type": {
      "description": "The object type",
      "type": ["string", "null"],
      "enum": ["Organization"]
    },
    "id": {
      "description": "The unique identifier for Organization",
      "type": ["string", "null"],
      "minLength": 0,
      "maxLength": 50
    },
    "alternateName": {
      "description": "Organization alternate name",
      "type": ["string", "null"],
      "minLength": 0,
      "maxLength": 100
    },
    "identifier": {
      "description": "The unique identifier for Organization",
      "type": ["string", "null"],
      "minLength": 0,
      "maxLength": 50
    },
    "image": {
      "description": "image URL",
      "type": ["string", "null"],
      "minLength": 0,
      "format": "uri"
    },
    "name": {
      "description": "The Organization Name",
      "type": "array",
      "items": { "$ref": "#/$defs/languageTaggedString" },
      "minItems": 1
    },
    "description": {
      "description": "The Organization Description",
      "type": "array",
      "items": { "$ref": "#/$defs/languageTaggedString" }
    },
    "sameAs": {
      "description": "The Organization sameAs",
      "type": "array",
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "url": {
      "description": "This Organization URL",
      "type": ["string", "null"],
      "format": "uri",
      "minLength": 1
    },
    "address": {
      "description": "The postal address of the organization",
      "anyOf": [
        { "$ref": "#/$defs/postalAddress" },
        { "type": "null" }
      ]
    },
    "brand": {
      "description": "Brand URL",
      "type": ["string", "null"],
      "minLength": 0,
      "format": "uri"
    },
    "contactPoint": {
      "type": "array",
      "items": {
        "anyOf": [
          { "$ref": "#/$defs/contactPoint" },
          { "type": "null" }
        ]
      }
    },
    "department": {
      "description": "This Organization Department",
      "type": ["string", "null"],
      "format": "uri"
    },
    "dissolutionDate": {
      "description": "This Organization dissolution date",
      "type": ["string", "null"],
      "format": "date-time"
    },
    "duns": {
      "description": "This Organization DUNS number",
      "type": ["string", "null"]
    },
    "email": {
      "type": ["string", "null"],
      "format": "email"
    },
    "founder": {
      "description": "The Organization founder(s)",
      "type": ["array", "null"],
      "items": {
        "type": "string"
      }
    },
    "foundingDate": {
      "description": "This Organization founding date",
      "type": ["string", "null"],
      "format": "date-time"
    },
    "globalLocationNumber": {
      "description": "This Organization Global Location Number",
      "type": ["string", "null"]
    },
    "hasGS1DigitalLink": {
      "description": "This Organization GS1 Digital Link",
      "type": ["string", "null"]
    },
    "hasOfferCatalog": {
      "description": "The Organization Offer Catalogs",
      "type": ["array", "null"],
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "isicV4": {
      "description": "This Organization isicV4",
      "type": ["string", "null"]
    },
    "iso6523Code": {
      "description": "This Organization iso6523 Code",
      "type": ["string", "null"]
    },
    "legalAddress": {
      "description": "The legal address of the organization",
      "anyOf": [
        { "$ref": "#/$defs/postalAddress" },
        { "type": "null" }
      ]
    },
    "legalName": {
      "description": "This Organization legal name",
      "type": ["string", "null"]
    },
    "leiCode": {
      "description": "This Organization lei Code",
      "type": ["string", "null"]
    },
    "logo": {
      "description": "The Organization logo",
      "type": ["string", "null"],
      "format": "uri"
    },
    "member": {
      "description": "The Organization Members",
      "type": ["array", "null"],
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "memberOf": {
      "description": "The Organizations URLs this Organization is a Member of",
      "type": ["array", "null"],
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "naics": {
      "description": "This Organization naics Code",
      "type": ["string", "null"]
    },
    "parentOrganization": {
      "description": "This Organization parent Organization URL",
      "type": ["string", "null"],
      "format": "uri"
    },
    "review": {
      "description": "The Organizations Reviews URLs",
      "type": ["array", "null"],
      "items": {
        "type": "string",
        "format": "uri"
      }
    },
    "slogan": {
        "description": "The Organization slogan",
        "type": ["array", "null"],
        "items": { "$ref": "#/$defs/languageTaggedString" }
    },
    "taxID": {
      "description": "This Organization taxID",
      "type": ["string", "null"]
    },
    "telephone": {
      "description": "The Organization telephone",
      "type": ["string", "null"],
      "minLength": 1,
      "maxLength": 20
    },
    "vatID": {
      "description": "This Organization vatID",
      "type": ["string", "null"]
    },
    "tags": {
      "description": "Object Tags",
      "type": ["array", "null"],
      "items": { "$ref": "#/$defs/tag" }
    }
  },
  "required": ["name"],


  "$defs": {
    "postalAddress": {
      "description": "The Organization address",
      "properties": {
        "at_type": {
          "description": "The object type",
          "type": ["string", "null"],
          "enum": ["PostalAddress"]
        },
        "addressCountry": {
          "type": "string",
          "minLength": 2,
          "maxLength": 2
        },
        "addressLocality": {
          "type": "string",
          "minLength": 1,
          "maxLength": 100
        },
        "addressRegion": {
          "type": ["string", "null"],
          "minLength": 0,
          "maxLength": 100
        },
        "extendedAddress": {
          "type": ["string", "null"],
          "minLength": 0,
          "maxLength": 100
        },
        "postOfficeBoxNumber": {
          "type": ["string", "null"],
          "minLength": 0,
          "maxLength": 20
        },
        "postalCode": {
          "type": "string",
          "minLength": 1,
          "maxLength": 20
        },
        "streetAddress": {
          "type": "string",
          "minLength": 1,
          "maxLength": 255
        }
      },
      "required": ["streetAddress","addressCountry", "postalCode"]
    },
    "contactPoint": {
      "type": "object",
      "description": "The Organization contact point",
      "properties": {
        "at_type": {
          "description": "The object type",
          "type": ["string", "null"],
          "enum": ["ContactPoint"]
        },
        "telephone": {
          "type": ["string", "null"],
          "minLength": 1,
          "maxLength": 20
        },
        "contactType": {
          "type": ["string", "null"],
          "minLength": 1,
          "maxLength": 100
        },
        "areaServed": {
          "type": ["string", "null"],
          "minLength": 1,
          "maxLength": 100
        },
        "availableLanguage": {
          "type": ["string", "null"],
          "minLength": 2,
          "maxLength": 2
        },
        "email": {
          "type": ["string", "null"],
          "format": "email"
        }
      },
      "anyOf": [
        { "required": ["email"] },
        { "required": ["telephone"] }
      ]
    },
    "languageTaggedString": {
      "type": "object",
      "properties": {
        "at_value": {
          "type": "string",
          "minLength": 1
        },
        "at_language": {
          "type": "string",
          "minLength": 2
        }
      },
      "required": ["at_value", "at_language"]
    },
    "tag": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1
        },
        "val": {
          "type": "string",
          "minLength": 1
        }
      },
      "required": ["name", "val"]
    }
  }
}