Graph API and parameters for Accept request header

27/05/2023
ODataGraph API

By default, when calling Graph API endpoints the Accept request header must contain application/json.

You can set additional format parameters in the Accept request header and these format parameters have impact on the amount, format and order of information in the response.

Let's focus on three possible format parameters odata.metadata, IEEE754Compatible and odata.streaming.

The amount of control information in response

The odata.metadata parameter can be applied to the Accept header of a Graph API request to influence how much control information will be included in the response.
Possible values are minimal, full and none.

odata.metadata=minimal

The odata.metadata=minimal format parameter indicates that the Graph API should remove computable control information from the payload wherever possible.

Request

GET https://graph.microsoft.com/v1.0/users/{user-id}
Accept: application/json;odata.metadata=minimal

Response

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
    "businessPhones": [
        "+1 425 555 0109"
    ],
    "displayName": "Adele Vance",
    "givenName": "Adele",
    "jobTitle": "Retail Manager",
    "mail": "AdeleV@4wrvkx.onmicrosoft.com",
    "mobilePhone": null,
    "officeLocation": "18/2111",
    "preferredLanguage": "en-US",
    "surname": "Vance",
    "userPrincipalName": "AdeleV@4wrvkx.onmicrosoft.com",
    "id": "61b0c52f-a902-abcd-0123-c6628335b00a"
}

When odata.metadata is set to minimal the response contains only @odata.context annotation which returns the context URL for the payload.

Besides @odata.context the response should contain

  • @odata.etag: the ETag of the entity
  • @odata.nextLink: the next link of a collection with partial results
  • @odata.deltaLink: the delta link for obtaining changes, if requested
  • @odata.count: the total count of entities, if requested

odata.metadata=full

The odata.metadata=full format parameter indicates that the Graph API must include all control information explicitly in the payload.

Request

GET https://graph.microsoft.com/v1.0/users/{user-id}
Accept: application/json;odata.metadata=full

Response

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
    "@odata.type": "#microsoft.graph.user",
    "@odata.id": "users('61b0c52f-a902-abcd-0123-c6628335b00a')",
    "@odata.editLink": "users('61b0c52f-a902-abcd-0123-c6628335b00a')",
    "businessPhones@odata.type": "#Collection(String)",
    "businessPhones": [
        "+1 425 555 0109"
    ],
    "displayName": "Adele Vance",
    "givenName": "Adele",
    "jobTitle": "Retail Manager",
    "mail": "AdeleV@4wrvkx.onmicrosoft.com",
    "mobilePhone": null,
    "officeLocation": "18/2111",
    "preferredLanguage": "en-US",
    "surname": "Vance",
    "userPrincipalName": "AdeleV@4wrvkx.onmicrosoft.com",
    "id": "61b0c52f-a902-abcd-0123-c6628335b00a",
    "appRoleAssignments@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/appRoleAssignments/$ref",
    "appRoleAssignments@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/appRoleAssignments",
    "createdObjects@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/createdObjects/$ref",
    "createdObjects@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/createdObjects",
    "directReports@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/directReports/$ref",
    "directReports@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/directReports",
    "licenseDetails@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/licenseDetails/$ref",
    "licenseDetails@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/licenseDetails",
    "manager@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/manager/$ref",
    "manager@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/manager",
    "memberOf@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/memberOf/$ref",
    "memberOf@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/memberOf",
    "oauth2PermissionGrants@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/oauth2PermissionGrants/$ref",
    "oauth2PermissionGrants@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/oauth2PermissionGrants",
    "ownedDevices@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/ownedDevices/$ref",
    "ownedDevices@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/ownedDevices",
    "ownedObjects@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/ownedObjects/$ref",
    "ownedObjects@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/ownedObjects",
    "registeredDevices@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/registeredDevices/$ref",
    "registeredDevices@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/registeredDevices",
    "scopedRoleMemberOf@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/scopedRoleMemberOf/$ref",
    "scopedRoleMemberOf@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/scopedRoleMemberOf",
    "transitiveMemberOf@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/transitiveMemberOf/$ref",
    "transitiveMemberOf@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/transitiveMemberOf",
    "calendar@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/calendar/$ref",
    "calendar@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/calendar",
    "calendarGroups@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/calendarGroups/$ref",
    "calendarGroups@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/calendarGroups",
    "calendars@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/calendars/$ref",
    "calendars@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/calendars",
    "calendarView@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/calendarView/$ref",
    "calendarView@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/calendarView",
    "contactFolders@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/contactFolders/$ref",
    "contactFolders@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/contactFolders",
    "contacts@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-4769-9a09-c6628335b00a')/contacts/$ref",
    "contacts@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/contacts",
    "events@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/events/$ref",
    "events@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/events",
    "inferenceClassification@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/inferenceClassification/$ref",
    "inferenceClassification@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/inferenceClassification",
    "mailFolders@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/mailFolders/$ref",
    "mailFolders@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/mailFolders",
    "messages@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/messages/$ref",
    "messages@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/messages",
    "outlook@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/outlook/$ref",
    "outlook@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/outlook",
    "people@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/people/$ref",
    "people@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/people",
    "drive@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/drive/$ref",
    "drive@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/drive",
    "drives@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/drives/$ref",
    "drives@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/drives",
    "followedSites@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/followedSites/$ref",
    "followedSites@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/followedSites",
    "extensions@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/extensions/$ref",
    "extensions@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/extensions",
    "agreementAcceptances@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/agreementAcceptances/$ref",
    "agreementAcceptances@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/agreementAcceptances",
    "managedDevices@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/managedDevices/$ref",
    "managedDevices@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/managedDevices",
    "managedAppRegistrations@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/managedAppRegistrations/$ref",
    "managedAppRegistrations@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/managedAppRegistrations",
    "deviceManagementTroubleshootingEvents@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/deviceManagementTroubleshootingEvents/$ref",
    "deviceManagementTroubleshootingEvents@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/deviceManagementTroubleshootingEvents",
    "planner@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/planner/$ref",
    "planner@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/planner",
    "insights@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/insights/$ref",
    "insights@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/insights",
    "settings@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/settings/$ref",
    "settings@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/settings",
    "onenote@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/onenote/$ref",
    "onenote@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/onenote",
    "photo@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-01239-c6628335b00a')/photo/$ref",
    "photo@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/photo",
    "photos@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/photos/$ref",
    "photos@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/photos",
    "activities@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/activities/$ref",
    "activities@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/activities",
    "onlineMeetings@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/onlineMeetings/$ref",
    "onlineMeetings@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/onlineMeetings",
    "presence@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/presence/$ref",
    "presence@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/presence",
    "authentication@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/authentication/$ref",
    "authentication@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/authentication",
    "chats@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/chats/$ref",
    "chats@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/chats",
    "joinedTeams@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/joinedTeams/$ref",
    "joinedTeams@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/joinedTeams",
    "teamwork@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/teamwork/$ref",
    "teamwork@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/teamwork",
    "todo@odata.associationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/todo/$ref",
    "todo@odata.navigationLink": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/todo",
    "#microsoft.graph.assignLicense": {
        "title": "microsoft.graph.assignLicense",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.assignLicense"
    },
    "#microsoft.graph.changePassword": {
        "title": "microsoft.graph.changePassword",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.changePassword"
    },
    "#microsoft.graph.reprocessLicenseAssignment": {
        "title": "microsoft.graph.reprocessLicenseAssignment",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.reprocessLicenseAssignment"
    },
    "#microsoft.graph.revokeSignInSessions": {
        "title": "microsoft.graph.revokeSignInSessions",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.revokeSignInSessions"
    },
    "#microsoft.graph.findMeetingTimes": {
        "title": "microsoft.graph.findMeetingTimes",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.findMeetingTimes"
    },
    "#microsoft.graph.getMailTips": {
        "title": "microsoft.graph.getMailTips",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.getMailTips"
    },
    "#microsoft.graph.sendMail": {
        "title": "microsoft.graph.sendMail",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.sendMail"
    },
    "#microsoft.graph.translateExchangeIds": {
        "title": "microsoft.graph.translateExchangeIds",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.translateExchangeIds"
    },
    "#microsoft.graph.removeAllDevicesFromManagement": {
        "title": "microsoft.graph.removeAllDevicesFromManagement",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.removeAllDevicesFromManagement"
    },
    "#microsoft.graph.wipeManagedAppRegistrationsByDeviceTag": {
        "title": "microsoft.graph.wipeManagedAppRegistrationsByDeviceTag",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.wipeManagedAppRegistrationsByDeviceTag"
    },
    "#microsoft.graph.exportPersonalData": {
        "title": "microsoft.graph.exportPersonalData",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.exportPersonalData"
    },
    "#microsoft.graph.reminderView": {
        "title": "microsoft.graph.reminderView",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.reminderView"
    },
    "#microsoft.graph.exportDeviceAndAppManagementData()": {
        "title": "microsoft.graph.exportDeviceAndAppManagementData",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.exportDeviceAndAppManagementData"
    },
    "#microsoft.graph.exportDeviceAndAppManagementData(skip,top)": {
        "title": "microsoft.graph.exportDeviceAndAppManagementData",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.exportDeviceAndAppManagementData(skip=@skip,top=@top)"
    },
    "#microsoft.graph.getManagedAppDiagnosticStatuses": {
        "title": "microsoft.graph.getManagedAppDiagnosticStatuses",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.getManagedAppDiagnosticStatuses"
    },
    "#microsoft.graph.getManagedAppPolicies": {
        "title": "microsoft.graph.getManagedAppPolicies",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.getManagedAppPolicies"
    },
    "#microsoft.graph.getManagedDevicesWithAppFailures": {
        "title": "microsoft.graph.getManagedDevicesWithAppFailures",
        "target": "https://graph.microsoft.com/v1.0/users('61b0c52f-a902-abcd-0123-c6628335b00a')/microsoft.graph.getManagedDevicesWithAppFailures"
    }
}

Besides @odata.context, @odata.etag, @odata.nextLink, @odata.deltaLink and @odata.count the response must contain

  • @odata.id: the id of the entity
  • @odata.type: the type of a JSON object. Primitive types are specified by the namespace-qualified or alias-qualified name. Properties that represent a collection of values are specified by the namespace-qualified or alias-qualified element type enclosed in parentheses and prefixed with Collection
  • @odata.readLink: the read URL of the entity, returned if the edit link cannot be used to read the entity
  • @odata.editLink: the edit URL of the entity
  • @odata.navigationLink: the navigation URL to retrieve an entity or collection of entities related to the current entity via a navigation property
  • @odata.associationLink: the association URL to retrieve a reference to an entity or a collection of references to entities related to the current entity via a navigation property

odata.metadata=none

The odata.metadata=none format parameter indicates that the Graph API omit control information other than odata.nextLink and odata.count.

Request

GET https://graph.microsoft.com/v1.0/users/{user-id}
Accept: application/json;odata.metadata=none

Response

{
    "businessPhones": [
        "+1 425 555 0109"
    ],
    "displayName": "Adele Vance",
    "givenName": "Adele",
    "jobTitle": "Retail Manager",
    "mail": "AdeleV@4wrvkx.onmicrosoft.com",
    "mobilePhone": null,
    "officeLocation": "18/2111",
    "preferredLanguage": "en-US",
    "surname": "Vance",
    "userPrincipalName": "AdeleV@4wrvkx.onmicrosoft.com",
    "id": "61b0c52f-a902-abcd-0123-c6628335b00a"
}

It is not valid to specify odata.metadata=none on a delta request.

The representation of numbers

Serialization of Edm.Int64 and Edm.Decimal numbers (including the odata.count, if requested) is controlled by the IEEE754Compatible format parameter. Possible values are true and false.

IEEE754Compatible=true

The IEEE754Compatible=true format parameter indicates that the Graph API serializes Edm.Int64, Edm.Decimal numbers, including the odata.count annotation as strings.

Request

GET https://graph.microsoft.com/v1.0/me/messages?$count=true
Accept: application/json;IEEE754Compatible=true

Response

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('61b0c52f-a902-abcd-0123-c6628335b00a')/messages",
    "@odata.count": "35",
    "value": [
    ...
    ],
    "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/messages?%24count=true&%24top=10&%24skip=10"
}

Request

GET https://graph.microsoft.com/v1.0/me/drive/root/children
Accept: application/json;IEEE754Compatible=true

Response

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('61b0c52f-a902-abcd-0123-c6628335b00a')/drive/root/children",
    "value": [
        {
            ...
            "id": "01JI7S3EIP7WBTDCHHVVBIMUR64YHLR2ED",
            "name": "Document.docx",
            "size": "10563",
           ...
        }
    ]
}

IEEE754Compatible=false

The IEEE754Compatible=false format parameter indicates that the Graph API serializes Edm.Int64, Edm.Decimal numbers, including the odata.count annotation as JSON numbers.

Request

GET https://graph.microsoft.com/v1.0/me/messages?$count=true
Accept: application/json;IEEE754Compatible=false

Response

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('61b0c52f-a902-abcd-0123-c6628335b00a')/messages",
    "@odata.count": 35,
    "value": [
    ...
    ],
    "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/messages?%24count=true&%24top=10&%24skip=10"
}

Request

GET https://graph.microsoft.com/v1.0/me/drive/root/children
Accept: application/json;IEEE754Compatible=false

Response

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('61b0c52f-a902-abcd-0123-c6628335b00a')/drive/root/children",
    "value": [
        {
            ...
            "id": "01JI7S3EIP7WBTDCHHVVBIMUR64YHLR2ED",
            "name": "Document.docx",
            "size": 10563,
           ...
        }
    ]
}

Payload ordering constraints

The odata.streaming format parameter describes ordering of properties within a JSON response. Clients can optimize processing of a JSON response if certain ordering constraints are applied.

Ordering constraints are:

  • The odata.context annotation must be the first property in the JSON object
  • The odata.type annotation, if present, is next
  • The odata.id and odata.etag annotations must appear before any property or property annotation
  • Annotations for a structural or navigation property must appear as a group immediately before the property they annotate
  • All other odata annotations can appear anywhere in the payload
  • Annotations for navigation properties must appear after all structural properties.

The Graph API always optimizes a JSON response regardless the fact that odata.streaming=true or odata.streaming=false.

2
Buy Me a Coffee at ko-fi.com
An error has occurred. This application may no longer respond until reloaded. Reload x