Microsoft Graph · Schema

microsoft.graph.organization

Azure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Task
View JSON Schema on GitHub

JSON Schema

microsoft-graph-microsoftgraphorganization-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/microsoft.graph.organization",
  "title": "microsoft.graph.organization",
  "allOf": [
    {
      "$ref": "#/components/schemas/microsoft.graph.directoryObject"
    },
    {
      "title": "organization",
      "required": [
        "@odata.type"
      ],
      "type": "object",
      "properties": {
        "assignedPlans": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.assignedPlan"
          },
          "description": "The collection of service plans associated with the tenant. Not nullable."
        },
        "businessPhones": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Telephone number for the organization. Although this property is a string collection, only one number can be set."
        },
        "city": {
          "type": "string",
          "description": "City name of the address for the organization.",
          "nullable": true
        },
        "country": {
          "type": "string",
          "description": "Country or region name of the address for the organization.",
          "nullable": true
        },
        "countryLetterCode": {
          "type": "string",
          "description": "Country or region abbreviation for the organization in ISO 3166-2 format.",
          "nullable": true
        },
        "createdDateTime": {
          "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
          "type": "string",
          "description": "Timestamp of when the organization was created. The value can't be modified and is automatically populated when the organization is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.",
          "format": "date-time",
          "nullable": true
        },
        "defaultUsageLocation": {
          "type": "string",
          "description": "Two-letter ISO 3166 country code indicating the default service usage location of an organization.",
          "nullable": true
        },
        "displayName": {
          "type": "string",
          "description": "The display name for the tenant.",
          "nullable": true
        },
        "marketingNotificationEmails": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Not nullable."
        },
        "mobileDeviceManagementAuthority": {
          "$ref": "#/components/schemas/microsoft.graph.mdmAuthority"
        },
        "onPremisesLastSyncDateTime": {
          "pattern": "^[0-9]{4,}-(0[1-9]|1[012])-(0[1-9]|[12][0-9]|3[01])T([01][0-9]|2[0-3]):[0-5][0-9]:[0-5][0-9]([.][0-9]{1,12})?(Z|[+-][0-9][0-9]:[0-9][0-9])$",
          "type": "string",
          "description": "The time and date at which the tenant was last synced with the on-premises directory. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Read-only.",
          "format": "date-time",
          "nullable": true
        },
        "onPremisesSyncEnabled": {
          "type": "boolean",
          "description": "true if this object is synced from an on-premises directory; false if this object was originally synced from an on-premises directory but is no longer synced. Nullable. null if this object isn't synced from on-premises active directory (default).",
          "nullable": true
        },
        "partnerTenantType": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.partnerTenantType"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The type of partnership this tenant has with Microsoft. The possible values are: microsoftSupport, syndicatePartner, breadthPartner, breadthPartnerDelegatedAdmin, resellerPartnerDelegatedAdmin, valueAddedResellerPartnerDelegatedAdmin, unknownFutureValue. Nullable. For more information about the possible types, see partnerTenantType values."
        },
        "postalCode": {
          "type": "string",
          "description": "Postal code of the address for the organization.",
          "nullable": true
        },
        "preferredLanguage": {
          "type": "string",
          "description": "The preferred language for the organization. Should follow ISO 639-1 Code; for example, en.",
          "nullable": true
        },
        "privacyProfile": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.privacyProfile"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "The privacy profile of an organization."
        },
        "provisionedPlans": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.provisionedPlan"
          },
          "description": "Not nullable."
        },
        "securityComplianceNotificationMails": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Not nullable."
        },
        "securityComplianceNotificationPhones": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Not nullable."
        },
        "state": {
          "type": "string",
          "description": "State name of the address for the organization.",
          "nullable": true
        },
        "street": {
          "type": "string",
          "description": "Street name of the address for organization.",
          "nullable": true
        },
        "technicalNotificationMails": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Not nullable."
        },
        "tenantType": {
          "type": "string",
          "description": "Not nullable. Can be one of the following types:  AAD - An enterprise identity access management (IAM) service that serves business-to-employee and business-to-business (B2B) scenarios.  AAD B2C An identity access management (IAM) service that serves business-to-consumer (B2C) scenarios.   CIAM - A customer identity & access management (CIAM) solution that provides an integrated platform to serve consumers, partners, and citizen scenarios.",
          "nullable": true
        },
        "verifiedDomains": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.verifiedDomain"
          },
          "description": "The collection of domains associated with this tenant. Not nullable."
        },
        "branding": {
          "anyOf": [
            {
              "$ref": "#/components/schemas/microsoft.graph.organizationalBranding"
            },
            {
              "type": "object",
              "nullable": true
            }
          ],
          "description": "Branding for the organization. Nullable.",
          "x-ms-navigationProperty": true
        },
        "certificateBasedAuthConfiguration": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.certificateBasedAuthConfiguration"
          },
          "description": "Navigation property to manage certificate-based authentication configuration. Only a single instance of certificateBasedAuthConfiguration can be created in the collection.",
          "x-ms-navigationProperty": true
        },
        "extensions": {
          "type": "array",
          "items": {
            "$ref": "#/components/schemas/microsoft.graph.extension"
          },
          "description": "The collection of open extensions defined for the organization. Read-only. Nullable.",
          "x-ms-navigationProperty": true
        },
        "@odata.type": {
          "type": "string",
          "default": "#microsoft.graph.organization"
        }
      }
    }
  ],
  "x-ms-discriminator-value": "#microsoft.graph.organization"
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/microsoft-graph-microsoftgraphorganization"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.