Clarification needed for SPFile vs SPListItem entries and ListItem Id property in manifest XML

What type of issue is this?

Question

What SharePoint development model, framework, SDK or API is this about?

SharePoint REST API

Target SharePoint environment

SharePoint Online

What browser(s) / client(s) have you tested

• 💥 Internet Explorer
• 💥 Microsoft Edge
• 💥 Google Chrome
• 💥 FireFox
• 💥 Safari
• mobile (iOS/iPadOS)
• mobile (Android)
• not applicable
• other (enter in the "Additional environment details" area below)

Additional environment details

Sharepoint Rest API V1 - SharePoint Asynchronous Metadata Read (AMR) API endpoint

Issue description

I tested the SharePoint Asynchronous Metadata Read (AMR) API to retrieve the metadata manifest XML.

In the resulting XML, I noticed that each file and folder has two entries:

• SPFile
• SPListItem

These two entries look very similar, with only slight differences.

I have a few questions that are unclear from the current documentation.

Questions

1. For import operations using the SharePoint Migration API, do we need to use both SPFile and SPListItem entries, or is one of them sufficient?

2. The Id property differs between SPFile and SPListItem for the same file:

   • The Id in the SPFile entry matches the SharePoint UniqueId of the file.
   • The Id in the corresponding SPListItem entry is different and does not match any value returned in the ListItem REST/Graph response for that file.

   What does the Id property in the SPListItem object represent?

3. What is the Order property in the ListItem mean by ? it was not found in the documentations

---

Documentation mismatch

According to the Deployment Manifest documentation, the ListItem Id is described as:

“An integer value that identifies the list item”

However, in the AMR manifest XML:

• The Id value for SPListItem is of type GUID
• It does not appear to correspond to the list item integer ID or any other exposed identifier

---

Screenshots / References

• Screenshot showing both SPFile and SPListItem entries in the AMR manifest

• This is the SPFile Id for the SendfromAlias.docx file

• But for the same file, in the SPListItem Id it was different and I couldn't find any property with this value in the ListItem response of this file.

---

This clarification would help ensure correct and supported usage of the AMR output during migrations.

Thanks!