items/[itemID]: Item—REST APIs | Documentation for ArcGIS Enterprise

URL:https://[root]/content/items/[itemID]

Example usage

The following is a sample ArcGIS Online request URL used to access an individual item resource:

https://www.arcgis.com/sharing/rest/content/items/10ba62fe50864339a8a3e0f18ca85506?f=pjson

The following is a sample ArcGIS Enterprise request URL used to access an individual item resource:

https://machine.domain.com/webadaptor/sharing/rest/content/items/10ba62fe50864339a8a3e0f18ca85506?f=pjson

Description

An individual item resource returns the information for a specific organization item. An item is a unit of content in the organization. Each item has a unique identifier and a well-known URL that is independent of the owner of the item. An item can have associated JSON data that's available via the item data resource. For example, an item of type Map Package returns the actual bits corresponding to the map package via the item data resource.

The numViews is incremented when an item is opened.

Request parameters


Parameter	Details
[Common Parameters]	For a complete listing, see Common parameters.
f	The response format. The default format is html. Values: html \| json \| pjson

Response properties


Property	Details
id	The unique ID for this item.
owner	The username of the user who owns this item.
created	The date the item was created. Shown in UNIX time in milliseconds.
modified	The date the item was last modified. Shown in UNIX time in milliseconds.
name	The file name of the item for file types. Read-only.
title	The title of the item. This is the name that's displayed to users and by which they refer to the item. Every item must have a title.
url	The URL for the resource represented by the item. Applies only to items that represent web-accessible resources such as map services.
type	The GIS content type of this item. Example types include Web Map, Map Service, Shapefile, and Web Mapping Application. See the overview section of Items and item types to get an understanding of the item type hierarchy.
typeKeywords	An array of keywords that further describes the type of this item. Each item is tagged with a set of type keywords that are derived based on its primary type.
description	Item description.
tags	An array of user defined tags that describe the item.
snippet	A short summary description of the item.
thumbnail	The URL to the thumbnail used for the item.
extent	An array that defines the bounding rectangle of the item. Should always be in WGS84. Example `[ [ -117.78452081090789, 33.46744709844458 ], [ -72.31511555464664, 42.11377951830049 ] ]`
categories	An array of organization categories that are set on the item. Example `[ "/Categories/Hydrography/River", "/Categories/Protected sites" ]`
spatialReference	The coordinate system of the item.
accessInformation	Information on the source of the item and its copyright status.
licenseInfo	Any license information or restrictions.
culture	The item locale information (language and country).
access	Indicates the level of access to the item. Values: private \| shared \| org \| public
proxyFilter	A JSON object used to restrict service item response results based on specified filter, i.e. limit results returned from a geocode service based on defined filters.See serviceProxyFilter for object details.
properties	A JSON object that primarily applies to system requirements, Terms and Conditions, version, supported platforms, YouTube video ID, etc associated with the application. If the item is of type notebook, you can specify the runtime version of the notebook. Notebook example: `properties: {"notebookRuntimeName":"ArcGIS Notebook Python 3 Standard","notebookRuntimeVersion":"5.0"}`
appCategories	An array that primarily applies to a list of categories that the application item is applicable to.
industries	An array that primarily applies to industries associated with the application.
languages	An array that primarily applies to languages associated with the application.
largeThumbnail	Primarily applies to thumbnails associated with an application. The URL to the thumbnail used for the application.
banner	Primarily applies to the banner associated with an application. The URL to the banner used for the application.
screenshots	An array that primarily applies to screenshots associated with an application. The URL to the screenshots used for the application.
listed	If true, the item is listed in the marketplace
ownerFolder	The ID of the folder in which the owner has stored the item. The property is only returned to the item owner or the org admin.
size	The size of the item in bytes.
protected	Protects the item from deletion. false is the default.
commentsEnabled	Indicates if comments are allowed on the item.
numComments	Number of comments on the item.
numRatings	Number of ratings on the item.
avgRating	Average rating. Uses a weighted average called "Bayesian average."
numViews	Number of views of the item.
itemControl	(Optional) Indicates user's control to the item. Values: admin (for item owner and org admin) \| update (for members of groups with item update capability that the item is shared with)
contentStatus	Item content status. Organization members, as well as public members for verified organizations, can search for items that have these badges using the contentStatus filter. Authoritative items are automatically protected to prevent accidental deletion and are boosted in search results to increase visibility and encourage use. Example `"contentStatus": "org_authoritative"`
scoreCompleteness	Item information completeness score based upon item snippet, thumbnail, description, title, tags etc.
groupDesignations	Any special groups the item may belong to. Example `"groupDesignations":"livingatlas"`
lastViewed	The date/time the item was last accessed in UNIX format (in milliseconds). Example `"lastViewed":1613148239000` Note: The lastViewed property was introduced with the ArcGIS Online November 2022 update and is returned in the item JSON response when an item is accessed after the update. The default value is blank. The lastViewed value is updated each time the item details page is opened in the front-end UI, when the item data endpoint is accessed is the API, or when the feature service owned by the item is accessed.

JSON Response syntax

            
          

{
  "id": "<item id>",
  "owner": "<owner username>", 
  "created": date created shown in UNIX time,
  "modified": date modified shown in UNIX time,
  "name": <item name>,    
  "title": "<item title>",    
  "type": "<type>",    
  "typeKeywords": [      
    "<keyword1>",     
    "<keyword2>",     
    "<keyword3>",     
    "<keyword4>"   
  ],    
  "description": "<description>",    
  "tags": [      
    "<tag1>",      
    "<tag2>",     
    "<tag3>"    
  ],    
  "snippet": "<summary>",    
  "thumbnail": "<file name>",    
  "extent": [
    [        
      minX,        
      minY      
    ],
    [        
      maxX,        
      maxY     
    ]    
  ],    
  "spatialReference": <coordinate system>,  
  "categories": [
    "<category1>",
    "<category2>"
    ...
  ],  
  "accessInformation": <credits>,    
  "licenseInfo": "<access and use constraints>",    
  "culture": "<culture code>",
  "url": <url>, 
  "proxyFilter": {},   
  "access": "private | shared | org | public",    
  "size": <size>,
  "properties": {},
  "appCategories": [],
  "industries": [<list of industries>],
  "languages": [<list of languages],
  "largeThumbnail": <url to thumbnail>,
  "banner": <url to banner>,
  "screenshots": [<url to screenshots>],
  "listed": false,
  "ownerFolder": "<folder id>",
  "protected": true | false,
  "commentsEnabled": false | true,    
  "numComments": <number of comments>,    
  "numRatings": <number of ratings>,    
  "avgRating": <average rating>,    
  "numViews": <number of views>,
  "itemControl": "admin | update",
  "contentStatus": "<contentStatus>",
  "scoreCompleteness": <score>,
  "groupDesignations": <special groups list>,
  "lastViewed": <date/time in UNIX format>
}

JSON Response example

            
          

{
  "id": "10ba62fe50864339a8a3e0f18ca85506",
  "owner": "jsmith",
  "created": 1263404798000,
  "modified": 1256666605000,
  "name": null,
	 "title": "Highland Earthquake",
		"type": "Web Map",
  "typeKeywords": [
				"Web Map",
				"Map",
				"Online Map",
				"ArcGIS Online"
		],
		"description": "This web map shows recent earthquakes in Southern California, specifically 
     the city of Highland.  The web map presents a live map service from the USGS displayed over 
     pre-earthquake imagery of the area.",
  "tags": [
    "Highland"
    "Southern California",
    "earthquake",
    "earthquakes",
    "quake"
  ],
  "snippet": "This web map shows recent earthquakes around Southern California. The web map features 
     a live map service from the USGS NHSS displayed over pre-earthquake imagery of the area.",
  "thumbnail": "thumbnail/earthquake.jpg",
  "extent": [
    [
      -117.81,
      34.39
    ],
    [
      -116.56,
      33.72
    ]
  ],
  "spatialReference": null,
  "categories": [
    "/Categories/Hydrography/River",
    "/Categories/Protected sites"
  ],
  "accessInformation": null,
  "licenseInfo": "Please see: https://nhss.cr.usgs.gov/data.shtml and https://nhss.cr.usgs.gov/disclaim.shtml",
  "culture": "en-us",
  "url": null,
  "proxyFilter": null,
  "access": "org",
  "size": 612,
  "properties": null,
  "appCategories": [],
  "industries": [],
  "languages": [],
  "largeThumbnail": null,
  "banner": null,
  "screenshots": [],
  "listed": false,
  "ownerFolder": "12599675ae0c487ebe31defb86b0173e",
  "protected": true,
  "commentsEnabled": false,
  "numComments": 14,
  "numRatings": 21,
  "avgRating": 5,
  "numViews": 65,
  "itemControl": "admin",
  "contentStatus": "org_authoritative",
  "scoreCompleteness": 60,
  "groupDesignations": "livingatlas",
  "lastViewed": 1613148239000
}

Feedback on this topic?