[folderID]: Folder content

URL:: https://[root]/content/users/[username]/[folderID]
Methods:: GET

Example usage

The following is a sample ArcGIS Online request URL used to access the user content resource within a folder:

Use dark colors for code blocksCopy
https://org.arcgis.com/sharing/rest/content/users/jsmith/1851c185888a43fcb3d6fffb78ae7c94?f=pjson

The following is a sample ArcGIS Enterprise request URL used to access the user content resource within a folder:

Use dark colors for code blocksCopy
https://machine.domain.com/webadaptor/sharing/rest/content/users/jsmith/1851c185888a43fcb3d6fffb78ae7c94?f=pjson

Description

The user content resource returns information on the user's owned items within a folder. A user's content are items in a subfolder of the home folder with the given folder ID. Multilevel folders are not supported. Items in a folder are stored by reference and are not physically in a folder. Rather, they're stored as links to the original item (e.g. /content/items/<itemId>).

Request parameters

Parameter	Details
`[Common Parameters]`	For a complete listing, see Common parameters.
`ignoreTypes`	A filter used to ignore or exclude item types that are specified by the user. Use dark colors for code blocksCopy `1 Example: https://org.arcgis.com/sharing/rest/content/users/jsmith/1851c185888a43fcb3d6fffb78ae7c94?f=pjson&ignoreTypes=Web Map,Feature Service`
`num` (Optional)	The maximum number of results to be included in the result set response. The default value is `10`, and the maximum allowed value is `100`. Note that the actual number of returned results may be less than `num`. This happens when the number of results remaining after `start` is less than `num`. Example: Use dark colors for code blocksCopy `1 2 //Returns a max of 50 results in the response num=50`
`sortField`	Sets the sort field for folder items. Values: `title` \| `owner` \| `avgrating` \| `numviews` \| `created` \| `modified`
`sortOrder`	Sets sort order for folder items. Values: `asc` \| `desc`
`start` (Optional)	The number of the first entry in the result set response. The index number is 1-based. The default value of `start` is `1`. Example: Use dark colors for code blocksCopy `1 start=11`
`types`	Filter by item type. Multiple types can be filtered using commas. Item type is case sensitive. See items and item types for reference. Use dark colors for code blocksCopy `1 Example: https://org.arcgis.com/sharing/rest/content/users/jsmith/1851c185888a43fcb3d6fffb78ae7c94?f=pjson&Types=Web Map,Feature Service`

Response properties

Property	Details
`username`	The username of the content.
`total`	The total number of results found for the whole query.
`start`	The number of the first entry in the result set for this response. The index number is 1-based. Note If the `start` or `num` parameters are not provided, the results are paginated and will display 1000 items per page.
`num`	The number of results included in the result set for this response. Note If the `start` or `num` parameters are not provided, the results are paginated and will display 1000 items per page.
`nextStart`	The next entry index if the current result set doesn't contain all results, or -1 if it is the last batch.
`currentFolder`	The current folder listing the user's items.
`items`	The list of the user's items. See Item for response properties for more details.
`[folders] username`	The username of the owner of the folder.
`id`	The folder ID.
`title`	The folder title.
`created`	The date the folder was created. Shown in UNIX time.
`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: Use dark colors for code blocksCopy `1 "contentStatus": "org_authoritative"`

JSON Response syntax

The syntax example below demonstrates the user content response returned at the user content root level:

Use dark colors for code blocksCopy
{
  "username": "<username>",
  "total": <total number of items owned by the user>,
  "start": <the first record index in the response>,
  "num": <the number of items in the response>,
  "nextStart": <the next entry index>,
  "currentFolder": root folder,
  "items": [
    {
      "id": "<item id>",
      "owner": "<owner username>",
      "created": date created shown in UNIX time,
      "modified": date modified shown in UNIX time,
      "guid": <unique id>,
      "name": "<item name>",
      "title": "<item title>",
      "type": "<type>",
      "typeKeywords": [
        "<keyword1>",
        "<keyword2>",
        "<keyword3>",
        "<keyword4>"
      ],
      "description": <description>,
      "tags": [
        "<tag1>",
        "<tag2>"
      ],
      "snippet": <summary>,
      "thumbnail": <file name>,
      "extent": [
        [
          <minX>,
          <minY>
        ],
        [
          <maxX>,
          <maxY>
        ]
      ],
      "spatialReference": <coordinate system>,
      "accessInformation": <credits>,
      "licenseInfo": <access and use constraints>,
      "culture": "<culture code>",
      "url": <url>,
      "access": "private | shared | org | public",
      "size": <item size>,
      "contentStatus": "<contentStatus>",
      "numComments": <number of comments>,
      "numRatings": <number of ratings>,
      "avgRating": <average rating>,
      "numViews": <number of views>
    },
    {
      "id": "<item id>",
      "owner": "<owner username>",
      "created": date created shown in UNIX time,
      "modified": date modified shown in UNIX time,
      "guid": <unique id>,
      "name": "<item name>",
      "title": "<item title>",
      "type": "<type>",
      "typeKeywords": [
        "<keyword1>",
        "<keyword2>",
        "<keyword3>",
        "<keyword4>"
      ],
      "description": <description>,
      "tags": [
        "<tag1>",
        "<tag2>"
      ],
      "snippet": <summary>,
      "thumbnail": <file name>,
      "extent": [
        [
          <minX>,
          <minY>
        ],
        [
          <maxX>,
          <maxY>
        ]
      ],
      "spatialReference": <coordinate system>,
      "accessInformation": <credits>,
      "licenseInfo": <access and use constraints>,
      "culture": "<culture code>",
      "url": <url>,
      "access": "private | shared | org | public",
      "size": <item size>,
      "contentStatus": "<contentStatus>",
      "numComments": <number of comments>,
      "numRatings": <number of ratings>,
      "avgRating": <average rating>,
      "numViews": <number of views>
    }
  ],
  "folders": [
    {
      "username": "<username>",
      "id": "<folder id>",
      "title": "<folder title>",
      "created": date created shown in UNIX time
    }
  ]
}

The syntax example below demonstrates the user content response returned at the user content folder level:

Use dark colors for code blocksCopy
{
  "username": "<username>",
  "currentFolder": {
    "username": "<username>",
    "id": "<folder id>",
    "title": "<folder title>",
    "created": date created shown in UNIX time
  },
  "items": [
    {
      "id": "<item id>",
      "owner": "<owner username>",
      "created": date created shown in UNIX time,
      "modified": date modified shown in UNIX time,
      "guid": <unique id>,
      "name": <item name>,
      "title": "<title>",
      "type": "<item type>",
      "typeKeywords": [
        "<keyword1>",
        "<keyword2>",
        "<keyword3>",
        "<keyword4>"
      ],
      "description": <description>,
      "tags": [
        "<tag1>",
        "<tag2>",
        "<tag3>",
        "<tag4>"
      ],
      "snippet": "<summary>",
      "thumbnail": "<file name>",
      "extent": [
        [
          <minX>,
          <minY>
        ],
        [
          <maxX>,
          <maxY>
        ]
      ],
      "spatialReference": <coordinate system>,
      "accessInformation": <credits>,
      "licenseInfo": <access and use constraints>,
      "culture": "<culture code>",
      "url": <url>,
      "access": "private | shared | org | public",
      "size": <item size>,
      "contentStatus": "<contentStatus>",
      "numComments": <number of comments>,
      "numRatings": <number of ratings>,
      "avgRating": <average rating>,
      "numViews": <number of views>
    }
  ]
}

JSON Response examples

The sample response below demonstrates user content response returned at the user content root level:

Use dark colors for code blocksCopy
{
  "username": "jsmith33",
  "total": 10,
  "start": 1,
  "num": 2,
  "nextStart": 3,
  "currentFolder": null,
  "items": [
    {
      "id": "1851c185888a43fcb3d6fffb78ae7c94",
      "owner": "jsmith33",
      "created": 1264091913000,
      "modified": 1256666605000,
      "guid": null,
      "name": "Usa_Prime_Imagery",
      "title": "Usa_Prime_Imagery",
      "type": "Layer",
      "typeKeywords": [
        "Data",
        "Layer",
        "ArcGlobe",
        "ArcGIS Explorer",
        "lyr"
      ],
      "description": "This detailed imagery map presents satellite imagery for the world and
       high-resolution (1m or better) imagery for the United States."
      "tags": [
        "layer",
        "imagery"
      ],
      "snippet": "Imagery of Southern California",
      "thumbnail": null,
      "extent": [],
      "spatialReference": null,
      "accessInformation": "Provided by Satellite Technologies",
      "licenseInfo": "This imagery is licensed to Satellite Technologies and non-commercial use is allowed."
      "culture": "en-us",
      "url": null,
      "access": "public",
      "size": 38912,
      "contentStatus": "org_authoritative",
      "numComments": 3,
      "numRatings": 7,
      "avgRating": 4,
      "numViews": 23
    },
    {
      "id": "28c343b688224d0ca1b5ba741c28de6e",
      "item": "National_Parks_in_California.lpk",
      "itemType": "file",
      "owner": "jsmith33",
      "created": 1263460602000,
	     "modified": 1256666605000,
      "guid": "1D70DAC0-505A-463F-A948-B324FD18BE2A",
      "name": "National_Parks_in_California",
      "title": "National Parks in California",
      "type": "Layer Package",
      "typeKeywords": [
        "Data",
        "Layer Package",
	       "ArcGlobe",
	       "ArcGIS Explorer",
	       "lpk"
	     ],
	     "description": "The National Parks are one of our greatest treasures.  Explore the Parks located in California.",
	     "tags": ["Parks, California"],
	     "snippet": "National Parks of California",
	     "thumbnail": "nationalparks.png",
	     "extent": [
	       [
	         -130.098,
	         15.469
	       ],
	       [
	         -63.337,
	         54.048
	       ]
	     ],
	     "spatialReference": "GCS_North_American_1983",
	     "accessInformation": "esri",
	     "licenseInfo": "Public use",
	     "culture": "en-us",
	     "url": null,
	     "access": "shared",
	     "size": 1402923,
      "contentStatus": "org_authoritative",
	     "numComments": 8,
	     "numRatings": 4,
	     "avgRating": 5,
	     "numViews": 17
	   }
	 ],
	 "folders": [
    {
	     "username": "jsmith33",
	     "id": "1a9ad803da604628b08c968ce602a231",
	     "title": "Street Maps",
	     "created": 1266354151000
	   }
  ]
}

The sample response below demonstrates user content response returned at the user content folder level:

Use dark colors for code blocksCopy
{
  "username": "jsmith33",
  "currentFolder": {
    "username": "jsmith33",
    "id": "1a9ad803da604628b08c968ce602a231",
    "title": "Street Maps",
    "created": 1266354151000
  },
  "items": [
    {
      "id": "0c92f2674fe5442bb9974dfc947bdd43",
      "owner": "jsmith33",
      "created": 1266354432000,
      "modified": 1256666605000,
      "guid": null,
      "name": null,
      "title": "City of Redlands",
      "type": "Web Map",
      "typeKeywords": [
        "Web Map",
        "Map",
        "Online Map",
        "ArcGIS Online"
      ],
      "description": null,
      "tags": [
        "Redlands",
        "Streets",
        "Transportation",
        "Highways"
      ],
      "snippet": "Street map of the city of Redlands, including major highways",
      "thumbnail": "thumbnail/ago_downloaded.png",
      "extent": [
        [
          -117.2609,
          34.0122
        ],
        [
          -117.1043,
          34.0983
        ]
      ],
      "spatialReference": null,
      "accessInformation": null,
      "licenseInfo": null,
      "culture": "en-us",
      "url": null,
      "access": "private",
      "size": 195,
      "contentStatus": "org_authoritative",
      "numComments": -1,
      "numRatings": -1,
      "avgRating": -1,
      "numViews": -1
    }
  ]
}