Export (0) Print
Expand All

REST API reference and samples

apps for Office and SharePoint

Find documentation on MSDN about the SharePoint 2013 representational state transfer (REST) interface.

This page contains links to commonly used REST resources that are available for SharePoint 2013 developers.

Last modified: August 19, 2014

Applies to: apps for SharePoint | SharePoint Foundation 2013 | SharePoint Server 2013

In this article
SharePoint 2013 REST reference
SharePoint 2013 REST overviews
SharePoint 2013 REST code samples
Additional resources

Watch the video: SharePoint 2013 REST and OData fundamentals

Videos

Note Note

Some of the following links open to the documentation for the corresponding JavaScript object, which displays the REST endpoint at the bottom of the page.

REST core endpoints

Resource

Description

SP.ChangeCollection object (sp.js)

Represents a collection of SP.Change objects.

SP.EventReceiverDefinitionCollection object (sp.js)

Represents a collection of EventReceiverDefinition objects that are used to enumerate a list of registered event receivers for Microsoft SharePoint Foundation objects.

SP.EventReceiverDefinition object (sp.js)

SP.FeatureCollection object (sp.js)

Represents a collection of SP.Feature objects.

SP.Feature object (sp.js)

Represents an activated feature.

SP.RecycleBinItemCollection object (sp.js)

Represents a collection of SP.RecycleBinItem objects.

SP.RecycleBinItem object (sp.js)

Represents a Recycle Bin item in the Recycle Bin of a site or a site collection.

SP.RegionalSettings object (sp.js)

Represents regional settings that are used on the server that is running Microsoft SharePoint Foundation.

SP.Site object (sp.js)

Represents a collection of sites in a Web application, including a top-level Web site and all its subsites.

SP.TimeZoneCollection object (sp.js)

SP.TimeZone object (sp.js)

Web

Represents a SharePoint site.

SP.WebTemplateCollection object (sp.js)

Specifies a collection of site templates.

SP.WebTemplate object (sp.js)

Specifies a site definition or a site template that is used to instantiate a site.

REST list-related endpoints

Resource

Description

ListCollection

Represents a collection of List resources.

List

Represents a list on a SharePoint Web site.

ListItemCollection

Represents a collection of ListItem resources.

ListItem

Represents an item or row in a list.

SP.ContentTypeCollection object (sp.js)

Represents a collection of Web site or list content types.

SP.ContentType object (sp.js)

Represents a website, or list, content type.

FieldCollection

Represents a collection of Field resources.

Field

Represents a field in a list on a Microsoft SharePoint Foundation Web site.

SP.FieldLinkCollection object (sp.js)

Represents a collection of SP.FieldLink objects that are column or field references in a content type.

SP.FieldLink object (sp.js)

Specifies a reference to a field or field definition for a content type.

SP.FormCollection object (sp.js)

Represents a collection of SP.Form objects for a list.

SP.Form object (sp.js)

A form provides a display and editing interface for a single list item.

SP.InformationRightsManagementSettings object (sp.js)

SP.ListTemplateCollection object (sp.js)

Represents a collection of SP.ListTemplate objects.

SP.ListTemplate object (sp.js)

Specifies a list template.

SP.RelatedFieldCollection object (sp.js)

Represents a collection of SP.RelatedField objects storing properties of relationship lookup fields.

SP.RelatedField object (sp.js)

Specifies a relationship to a lookup field.

ViewCollection

Represents a collection of View resources.

View

Specifies a list view.

ViewFieldCollection

Represents a collection of fields in a list view.

REST endpoints for files and folders

Resource

Description

FileCollection

Represents a collection of File resources.

File

Represents a file in a SharePoint Web site that can be a Web Part Page, an item in a document library, or a file in a folder.

FileVersionCollection

Represents a collection of FileVersion resources.

FileVersion

Represents a version of an File resource.

FolderCollection

Represents a collection of Folder resources.

Folder

Represents a folder on a SharePoint Web site.

REST endpoints for users and groups

Resource

Description

GroupCollection

Represents a collection of Group resources.

Group

Represents a group on a Microsoft SharePoint Foundation website.

RoleAssignmentCollection

Represents a collection of RoleAssignment resources that defines all the role assignments for a securable object.

RoleAssignment

Defines the securable object role assignments for a user or group on the Web site, list, or list item.

RoleDefinitionCollection

Represents the collection of RoleDefinition resources which define the role definitions that are available for use within the site.

RoleDefinition

Defines a single role definition, including a name, description, and set of rights.

RoleDefinitionBindingCollection

Defines the role definitions that are bound to a role assignment object.

UserCollection

Represents a collection of User resources.

User

Represents a user in Microsoft SharePoint Foundation.

UserCustomActionCollection

Represents a collection of UserCustomAction resources.

UserCustomAction

Represents a custom action associated with a SharePoint list, Web site, or subsite.

Resource

Description

Get started with the SharePoint 2013 REST service

Get the basics of using the SharePoint 2013 REST service to access and update SharePoint data, using the REST and OData web protocol standards.

How to: Complete basic operations using SharePoint 2013 REST endpoints

Learn how to perform basic CRUD operations with the SharePoint 2013 REST interface.

SharePoint Search REST API overview

Add search functionality to client and mobile applications using the Search REST service in SharePoint Server 2013 and any technology that supports REST web requests.

User profiles REST API reference

Learn about SharePoint 2013 REST endpoints for user PeopleManager, ProfileLoader, UserProfile, and related resources.

Social feed REST API reference for SharePoint 2013

Learn about SharePoint 2013 REST endpoints for feed-related tasks.

Following people and content REST API reference for SharePoint 2013

Learn about SharePoint 2013 REST endpoints for following people and content.

Resource

Description

SharePoint 2013: Hello World remote app using REST

Learn how to create a basic "hello world" provider-hosted app for SharePoint that uses the SharePoint REST interface to read information about a SharePoint 2013 site from a remote web application.

SharePoint 2013: Using the search REST service from an app for SharePoint

Learn how to submit a search query to Search in SharePoint 2013 from within an app for SharePoint.

SharePoint 2013: Build REST queries and use REST to traverse a site

Learn how to use the SharePoint REST APIs to traverse a SharePoint 2013 site, and to create an app that builds queries that perform basic data operations on basic SharePoint entities that are exposed at REST endpoints.

SharePoint 2013: Perform basic data access operations by using REST in apps

Learn how to use the SharePoint REST APIs to perform basic data access operations on SharePoint 2013 lists and list items.

SharePoint 2013: Perform basic data operations on files and folders using REST

A code sample using REST and the SharePointJavaScript cross-domain library to perform basic operations on document libraries and files.

SharePoint 2013: Make app-only policy type calls in a remote app (REST)

Learn how to use the AllowAppOnlyPolicy attribute, with REST and OAuth, to call back into SharePoint 2013.

SharePoint 2013: Accessing external list with REST

Learn how to create an app for SharePoint that will use RESTful URLs to query and manipulate data in an external list.

SharePoint 2013: Use the chrome control and the cross-domain library (REST)

Learn how to include a remote webpage that hosts the chrome control and retrieves information from the host web by using the cross-domain library and REST in SharePoint 2013.

SharePoint 2013: Get list items by using the cross-domain library (REST)

Learn how to use the cross-domain library in apps for SharePoint to read items in a list hosted in the app web.

SharePoint 2013: Get the host web title using the cross-domain library (REST)

Learn how to use the cross-domain library in SharePoint 2013 to read the title property of the host web.

How to: Set custom permissions on a list by using the REST interface

Learn how to define custom, fine-grained permissions on a SharePoint list by using the REST interface and JavaScript.

Show:
© 2014 Microsoft