Microsoft Graph · Schema

microsoft.graph.organization

Microsoft GraphAzure ADCollaborationContactsDocumentsEmailGraphIdentityMicrosoftOffice 365PresentationsProductivitySpreadsheetsT1Task

Properties

Name Type Description
assignedPlans array The collection of service plans associated with the tenant. Not nullable.
businessPhones array Telephone number for the organization. Although this property is a string collection, only one number can be set.
city string City name of the address for the organization.
country string Country or region name of the address for the organization.
countryLetterCode string Country or region abbreviation for the organization in ISO 3166-2 format.
createdDateTime string 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 usi
defaultUsageLocation string Two-letter ISO 3166 country code indicating the default service usage location of an organization.
displayName string The display name for the tenant.
marketingNotificationEmails array Not nullable.
mobileDeviceManagementAuthority object
onPremisesLastSyncDateTime string 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 examp
onPremisesSyncEnabled boolean 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 synce
partnerTenantType object The type of partnership this tenant has with Microsoft. The possible values are: microsoftSupport, syndicatePartner, breadthPartner, breadthPartnerDelegatedAdmin, resellerPartnerDelegatedAdmin, valueA
postalCode string Postal code of the address for the organization.
preferredLanguage string The preferred language for the organization. Should follow ISO 639-1 Code; for example, en.
privacyProfile object The privacy profile of an organization.
provisionedPlans array Not nullable.
securityComplianceNotificationMails array Not nullable.
securityComplianceNotificationPhones array Not nullable.
state string State name of the address for the organization.
street string Street name of the address for organization.
technicalNotificationMails array Not nullable.
tenantType string 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 iden
verifiedDomains array The collection of domains associated with this tenant. Not nullable.
branding object Branding for the organization. Nullable.
certificateBasedAuthConfiguration array Navigation property to manage certificate-based authentication configuration. Only a single instance of certificateBasedAuthConfiguration can be created in the collection.
extensions array The collection of open extensions defined for the organization. Read-only. Nullable.
@odata.type string
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"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.