Microsoft Entra ID (formerly Azure AD)

Microsoft Entra ID (formerly Azure AD) Contacts.directory Object API

The contacts.directoryObject API from Microsoft Entra ID (formerly Azure AD) — 28 operation(s) for contacts.directoryobject.

GitHub OpenAPI

Operations 28

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /contacts/{orgContact-id}/directReports List an organizational contact's direct reports · List directReports #
Ask an LLM
“Who reports directly to this external contact in our directory?”
“How do I see every user and contact whose manager is set to an organizational contact?”
Tell an agent
List the direct reports of contact {contact}.
Show everyone who has organizational contact {contact} as their manager, users and contacts alike.
GET /contacts/{orgContact-id}/directReports/{directoryObject-id} Get one direct report of an organizational contact · Get directReports from contacts #
Ask an LLM
“Can I look up a single direct report of an org contact by its object ID?”
“What details come back for one specific person reporting to an external contact?”
Tell an agent
Get direct report {report} of contact {contact}.
Fetch the directory object {report} from the direct reports of org contact {contact}, whatever its type.
GET /contacts/{orgContact-id}/directReports/{directoryObject-id}/microsoft.graph.orgContact Get a contact's direct report cast as an org contact · Get the item of type microsoft.graph.directoryObject as… #
Ask an LLM
“How do I read a direct report of an org contact when that report is itself an organizational contact?”
“Can I get contact-specific fields for a direct report that is another external contact?”
Tell an agent
Get direct report {report} of contact {contact} as an organizational contact.
Return the orgContact properties of report {report} under contact {contact}.
GET /contacts/{orgContact-id}/directReports/{directoryObject-id}/microsoft.graph.user Get a contact's direct report cast as a user · Get the item of type microsoft.graph.directoryObject as microsoft.graph.user #
Ask an LLM
“How do I get user properties for someone who reports to an organizational contact?”
“Can I read a direct report of an org contact as a full user object?”
Tell an agent
Get direct report {report} of contact {contact} as a user.
Show the user record for report {report} who reports to org contact {contact}.
GET /contacts/{orgContact-id}/directReports/$count Count an organizational contact's direct reports · Get the number of the resource #
Ask an LLM
“How many people report directly to this organizational contact?”
“What is the total number of direct reports, of any type, under an external contact?”
Tell an agent
Count the direct reports of contact {contact}.
Tell me how many directory objects report to org contact {contact}.
GET /contacts/{orgContact-id}/directReports/microsoft.graph.orgContact List a contact's direct reports that are org contacts · Get the items of type microsoft.graph.orgContact in the… #
Ask an LLM
“Which of an org contact's direct reports are themselves organizational contacts?”
“Can I list only the external contacts that report to a contact, leaving out users?”
Tell an agent
List only the organizational contacts reporting to contact {contact}.
Show the direct reports of org contact {contact}, filtered to contact objects.
GET /contacts/{orgContact-id}/directReports/microsoft.graph.orgContact/$count Count a contact's direct reports that are org contacts · Get the number of the resource #
Ask an LLM
“How many organizational contacts report to this contact?”
“What's the count of external contacts, not users, under an org contact?”
Tell an agent
Count the organizational contacts that report to contact {contact}.
Give me the number of contact-type direct reports for org contact {contact}.
GET /contacts/{orgContact-id}/directReports/microsoft.graph.user List a contact's direct reports that are users · Get the items of type microsoft.graph.user in the… #
Ask an LLM
“Which users in our tenant report to an organizational contact?”
“Can I get just the user accounts among an external contact's direct reports?”
Tell an agent
List only the users reporting to contact {contact}.
Show the direct reports of org contact {contact}, filtered to user accounts.
GET /contacts/{orgContact-id}/directReports/microsoft.graph.user/$count Count a contact's direct reports that are users · Get the number of the resource #
Ask an LLM
“How many user accounts report to this organizational contact?”
“What's the number of users, excluding contacts, managed by an external contact?”
Tell an agent
Count the users that report to contact {contact}.
Report the total of user accounts, excluding contacts, that report to org contact {contact}.
GET /contacts/{orgContact-id}/manager Get an organizational contact's manager · Get manager #
Ask an LLM
“Who is the manager of this external contact in Microsoft Entra ID?”
“Can I find out which person an organizational contact reports to?”
Tell an agent
Get the manager of contact {contact}.
Show who org contact {contact} reports to.
GET /contacts/{orgContact-id}/memberOf List groups an org contact directly belongs to · List memberOf #
Ask an LLM
“Which groups is this organizational contact a direct member of?”
“How do I see the direct memberships of an external contact, without nested groups?”
Tell an agent
List the groups contact {contact} is directly a member of.
Show the direct memberOf entries for org contact {contact}.
GET /contacts/{orgContact-id}/memberOf/{directoryObject-id} Get one direct membership of an org contact · Get memberOf from contacts #
Ask an LLM
“Can I check a single group that an org contact directly belongs to by its ID?”
“What does one direct memberOf entry for an external contact look like?”
Tell an agent
Get direct membership {group} of contact {contact}.
Fetch the object {group} from the direct memberOf list of org contact {contact}.
GET /contacts/{orgContact-id}/memberOf/{directoryObject-id}/microsoft.graph.administrativeUnit Get an org contact's direct admin unit membership · Get the item of type microsoft.graph.directoryObject as… #
Ask an LLM
“How do I read an administrative unit that an org contact is directly in?”
“Can I get administrative unit details for one of a contact's direct memberships?”
Tell an agent
Get direct membership {unit} of contact {contact} as an administrative unit.
Show the administrative unit {unit} that org contact {contact} directly belongs to.
GET /contacts/{orgContact-id}/memberOf/{directoryObject-id}/microsoft.graph.group Get an org contact's direct group membership as a group · Get the item of type microsoft.graph.directoryObject as microsoft.graph.group #
Ask an LLM
“How do I get full group properties for a group an org contact is directly in?”
“Can I read one of an external contact's direct memberships as a group object?”
Tell an agent
Get direct membership {group} of contact {contact} as a group.
Show the group record {group} that org contact {contact} directly belongs to.
GET /contacts/{orgContact-id}/memberOf/$count Count an org contact's direct memberships · Get the number of the resource #
Ask an LLM
“How many groups and units is an organizational contact directly a member of?”
“What is the count of direct memberOf entries for an external contact?”
Tell an agent
Count the direct memberships of contact {contact}.
Tell me how many objects org contact {contact} is directly a member of.
GET /contacts/{orgContact-id}/memberOf/microsoft.graph.administrativeUnit List admin units an org contact directly belongs to · Get the items of type microsoft.graph.administrativeUnit in the… #
Ask an LLM
“Which administrative units directly include this organizational contact?”
“Can I list only admin units, not groups, among a contact's direct memberships?”
Tell an agent
List the administrative units contact {contact} is directly in.
Show the direct memberOf of org contact {contact}, filtered to administrative units.
GET /contacts/{orgContact-id}/memberOf/microsoft.graph.administrativeUnit/$count Count admin units an org contact directly belongs to · Get the number of the resource #
Ask an LLM
“How many administrative units is this org contact directly a member of?”
“What's the number of direct admin unit memberships for an external contact?”
Tell an agent
Count the administrative units contact {contact} directly belongs to.
Give me the direct admin unit membership count for org contact {contact}.
GET /contacts/{orgContact-id}/memberOf/microsoft.graph.group List groups, only, an org contact directly belongs to · Get the items of type microsoft.graph.group in the… #
Ask an LLM
“Which groups, excluding administrative units, is a contact directly a member of?”
“Can I list the direct group memberships of an external contact as group objects?”
Tell an agent
List only the groups contact {contact} is directly in, as group objects.
Show the direct memberOf of org contact {contact}, filtered to groups.
GET /contacts/{orgContact-id}/memberOf/microsoft.graph.group/$count Count groups an org contact directly belongs to · Get the number of the resource #
Ask an LLM
“How many groups is this org contact directly a member of, not counting admin units?”
“What's the direct group membership count for an external contact?”
Tell an agent
Count the groups contact {contact} directly belongs to.
Give me the direct group-only membership count for org contact {contact}.
GET /contacts/{orgContact-id}/transitiveMemberOf List all groups an org contact belongs to, nested · List transitiveMemberOf #
Ask an LLM
“Which groups is an organizational contact in, including groups it's nested under?”
“How do I get the full transitive group membership of an external contact?”
Tell an agent
List every group contact {contact} belongs to, including nested memberships.
Show the transitive memberOf of org contact {contact}.
GET /contacts/{orgContact-id}/transitiveMemberOf/{directoryObject-id} Get one transitive membership of an org contact · Get transitiveMemberOf from contacts #
Ask an LLM
“Can I check whether one nested group is among an org contact's transitive memberships?”
“What does a single transitive memberOf entry for a contact return?”
Tell an agent
Get transitive membership {group} of contact {contact}.
Fetch object {group} from the nested memberships of org contact {contact}.
GET /contacts/{orgContact-id}/transitiveMemberOf/{directoryObject-id}/microsoft.graph.administrativeUnit Get an org contact's nested admin unit membership · Get the item of type microsoft.graph.directoryObject as… #
Ask an LLM
“How do I read an administrative unit a contact belongs to through nesting?”
“Can I get admin unit details for one of an org contact's transitive memberships?”
Tell an agent
Get transitive membership {unit} of contact {contact} as an administrative unit.
Show the administrative unit {unit} that org contact {contact} belongs to directly or indirectly.
GET /contacts/{orgContact-id}/transitiveMemberOf/{directoryObject-id}/microsoft.graph.group Get an org contact's nested group membership as a group · Get the item of type microsoft.graph.directoryObject as microsoft.graph.group #
Ask an LLM
“How do I get group properties for a group a contact is in through nested membership?”
“Can I read one of an org contact's transitive memberships as a group object?”
Tell an agent
Get transitive membership {group} of contact {contact} as a group.
Show the group record {group} that org contact {contact} belongs to directly or through nesting.
GET /contacts/{orgContact-id}/transitiveMemberOf/$count Count an org contact's transitive memberships · Get the number of the resource #
Ask an LLM
“How many groups and units is an org contact in once nested memberships are included?”
“What's the total transitive membership count for an external contact?”
Tell an agent
Count all memberships of contact {contact}, including nested ones.
Tell me the transitive memberOf count for org contact {contact}.
GET /contacts/{orgContact-id}/transitiveMemberOf/microsoft.graph.administrativeUnit List admin units an org contact belongs to, nested · Get the items of type microsoft.graph.administrativeUnit in the… #
Ask an LLM
“Which administrative units include this contact directly or through nesting?”
“Can I list only admin units among an org contact's transitive memberships?”
Tell an agent
List the administrative units contact {contact} belongs to, including nested ones.
Show the transitive memberOf of org contact {contact}, filtered to administrative units.
GET /contacts/{orgContact-id}/transitiveMemberOf/microsoft.graph.administrativeUnit/$count Count admin units an org contact is in, nested · Get the number of the resource #
Ask an LLM
“How many administrative units is an org contact in once nesting is counted?”
“What's the transitive admin unit membership count for an external contact?”
Tell an agent
Count the administrative units contact {contact} belongs to, including nested ones.
Give me the transitive admin unit count for org contact {contact}.
GET /contacts/{orgContact-id}/transitiveMemberOf/microsoft.graph.group List groups, only, an org contact is in, nested · Get the items of type microsoft.graph.group in the… #
Ask an LLM
“Which groups, not admin units, contain this contact directly or through nesting?”
“Can I list an org contact's transitive memberships as group objects only?”
Tell an agent
List only the groups contact {contact} belongs to, including nested groups.
Show the transitive memberOf of org contact {contact}, filtered to groups.
GET /contacts/{orgContact-id}/transitiveMemberOf/microsoft.graph.group/$count Count groups an org contact is in, nested · Get the number of the resource #
Ask an LLM
“How many groups is an org contact in once nested group membership is counted?”
“What's the transitive group-only membership count for an external contact?”
Tell an agent
Count the groups contact {contact} belongs to, including nested groups.
Give me the transitive group count for org contact {contact}.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/overview
📖
Authentication
https://learn.microsoft.com/en-us/graph/auth/
📖
Documentation
https://learn.microsoft.com/en-us/graph/change-notifications-overview

Specifications

⚙
OpenAPI
https://artifacts.apis.io/azure-ad/openapi/azure-ad-contacts-directoryobject-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/azure-ad/json-schema/azure-ad-microsoft-graph-user-schema.json
📊
JSONSchema
https://artifacts.apis.io/azure-ad/json-schema/azure-ad-microsoft-graph-group-schema.json
📊
JSONSchema
https://artifacts.apis.io/azure-ad/json-schema/azure-ad-microsoft-graph-org-contact-schema.json
📊
JSONSchema
https://artifacts.apis.io/azure-ad/json-schema/azure-ad-microsoft-graph-administrative-unit-schema.json
📊
JSONSchema
https://artifacts.apis.io/azure-ad/json-schema/azure-ad-microsoft-graph-directory-object-schema.json

Other Resources

🔗
SDKs
https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
🔗
ChangeLog
https://developer.microsoft.com/en-us/graph/changelog
🔗
Webhooks
https://artifacts.apis.io/azure-ad/asyncapi/azure-ad-change-notifications-webhooks.yml

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • 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 API 
curl "https://apis.io/api/v1/apis/azure-ad:azure-ad-contacts-directoryobject-api"
All apis 
curl "https://apis.io/api/v1/apis?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.

GitHub Google LinkedIn

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

OpenAPI Specification

azure-ad-contacts-directoryobject-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Identity.DirectoryManagement Contacts.directory Object API
  version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
  description: Core
security:
- azureaadv2: []
tags:


# --- truncated at 32 KB (780 KB total) ---
# Full source: https://artifacts.apis.io/azure-ad/openapi/azure-ad-contacts-directoryobject-api-openapi.yml