OData Service for namespace microsoft.graph
OData Service for namespace microsoft.graph
Microsoft Graph is a unified API into Microsoft 365 data — mail, calendar, Teams, OneDrive, directory — the entry point for enterprise Microsoft integrations.
One endpoint covers the entire M365 surface
Some permissions require tenant admin consent
Register an Azure AD app at portal.azure.com, set permissions (delegated or application). Run OAuth to get an access_token, then call https://graph.microsoft.com/v1.0/... Common SDKs: @microsoft/microsoft-graph-client (JS), Microsoft.Graph (C#), msgraph-sdk (Python).
Uptime · 30-day window
About this API
Microsoft Graph unifies APIs spread across Outlook, Teams, SharePoint, OneDrive, Azure AD, Excel Online, and To Do into one REST endpoint. For enterprise developers that means no more writing one integration per M365 product — a single OAuth setup and one SDK can coordinate across them.
The permission model has two flavors. Delegated permissions act on behalf of a signed-in user — scopes are bounded by what the user themselves can do (e.g. read their own mail). Application permissions act as the app itself, require tenant admin consent, and can act across users (good for background jobs). Both use OAuth 2.0, but consent flows and token semantics differ. Pick the right one up front — switching later is painful.
Rate limiting is distributed: every service (Outlook, Teams, SharePoint, etc.) meters independently — there is no single global quota. Throttling returns 429 with a Retry-After header; clients must back off exponentially. Change Notifications (webhooks) let you avoid polling, but require a publicly accessible HTTPS endpoint.
What you can build
- 1Build mail / calendar / task integrations for M365 users
- 2Push external system updates into Teams channels
- 3Read OneDrive / SharePoint files for processing
- 4Sync users from Azure AD for SSO
- 5Read and write Excel Online from internal tools
Strengths & limitations
Strengths
- One endpoint covers the entire M365 surface
- Fine-grained application + delegated permission model
- Webhooks and Change Notifications push updates
- Official SDKs maintained in JS/C#/Python and more
Limitations
- Some permissions require tenant admin consent
- Rate limits are per-resource and hard to predict in advance
- Beta endpoints come with no SLA or backwards-compatibility promise
Example request
curl https://microsoft.com/<endpoint> \
-H "Authorization: Bearer $ACCESS_TOKEN"Getting started
Register an Azure AD app at portal.azure.com, set permissions (delegated or application). Run OAuth to get an access_token, then call https://graph.microsoft.com/v1.0/... Common SDKs: @microsoft/microsoft-graph-client (JS), Microsoft.Graph (C#), msgraph-sdk (Python).
FAQ
Is the Graph API free?+
Yes, but you need a valid Microsoft 365 / Azure AD tenant. Some features (certain Teams workflows) require paid plans.
Delegated or application permissions?+
Delegated for actions in the context of a signed-in user (read their own mail). Application for background or cross-user jobs.
What is admin consent?+
Some scopes affect more than the signed-in user (e.g. read all tenant users). A tenant admin must explicitly grant them.
v1.0 vs beta endpoints?+
v1.0 is GA with SLA and compatibility guarantees. Beta exposes earlier capabilities without stability promises — avoid in production.
Technical details
- Auth type
- oauth
- Pricing
- free
- Protocols
- REST
- SDKs
- javascript, typescript, python, csharp, java, go
- Response time
- 109 ms
- Last health check
- 5/12/2026, 7:37:52 AM
Endpoints
Parsed from the OpenAPI spec. Showing 12 of 11412 non-deprecated endpoints.
/adminadmin.adminGet admin
/adminadmin.adminUpdate admin
/admin/serviceAnnouncementadmin.serviceAnnouncementDelete navigation property serviceAnnouncement for admin
/admin/serviceAnnouncementadmin.serviceAnnouncementGet serviceAnnouncement from admin
/admin/serviceAnnouncementadmin.serviceAnnouncementUpdate the navigation property serviceAnnouncement in admin
/admin/serviceAnnouncement/healthOverviewsadmin.serviceAnnouncementList healthOverviews
/admin/serviceAnnouncement/healthOverviewsadmin.serviceAnnouncementCreate new navigation property to healthOverviews for admin
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}admin.serviceAnnouncementDelete navigation property healthOverviews for admin
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}admin.serviceAnnouncementGet healthOverviews from admin
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}admin.serviceAnnouncementUpdate the navigation property healthOverviews in admin
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}/issuesadmin.serviceAnnouncementGet issues from admin
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}/issuesadmin.serviceAnnouncementCreate new navigation property to issues for admin
11400 more endpoints not shown. See the OpenAPI spec for the full list.
More from Microsoft
Bing Autosuggest API returns search suggestions from a partial query — for search-box type-ahead completion.
Bing Computer Vision API analyzes images — OCR, object detection, face detection, scene captioning, content moderation.
Bing Custom Image Search restricts image search to a custom set of domains — the image counterpart of Bing Custom Search.
Bing Custom Search lets you define a custom domain subset and run Bing search against it — for vertical or enterprise search.
Custom Vision Prediction API runs inference using your trained Custom Vision model — upload an image, get classification labels and confidence scores.
Custom Vision Training API programmatically trains image-classification / object-detection models — create projects, upload labeled images, trigger training, publish iterations.
Bing Entity Search recognizes queries as named entities (people, places, organizations) and returns structured card info (description, image, related links).
Bing Image Search runs image search over Bing's web-wide image index — by keyword, similar image, aspect ratio, or size filter.
Alternatives to consider
Different providers solving similar problems. Picked by category, auth, pricing, and tag overlap.