/export: Export Item

URL:
https://[root]/content/users/[userName]/export
Methods:
POST

Example Usage

URL for Export Item

1
2
3
4
5
https://www.arcgis.com/sharing/rest/content/users/jsmith/export
itemId=345313e619df46f387f9ededbe15ac56
title:"MyExportedFeatures"
exportFormat="Shapefile"
exportParameters={"layers": [ {"id" : 0 } ] }

Description

Exports a service item (POST only) to the specified output format. Available only to users with an organizational subscription. Invokable only by the service item owner or an administrator.

Request Parameters

ParameterDetails

[Common Parameters]

For a complete listing, see Common parameters.

itemId

The ID of the item to be exported.

Example: itemId=345313e619df46f387f9ededbe15ac56

exportFormat

The output format for the export.

Values: Shapefile | CSV | File Geodatabase | Feature Collection | GeoJson | Scene Package | KML | Excel

Example: exportFormat=Shapefile

exportParameters

A JSON object describing the layers to be exported and the export parameters for each layer.

Example: exportParameters= {"layers" : [ { "id" : 0 } ] }

Export Parameters JSON Object

The exportParameters JSON object is described below.

PropertyDescription

layers

(Required) An array of exportLayerInfo JSON objects that controls which layers are exported. Described in the table below.

targetSR

The target spatial reference for the exported features.

Export Layer Info JSON Object

The exportLayerInfo JSON object is described below.

PropertyDescription

id

(Required) The ID of the layer within the service to be exported.

where

A where clause used to filter features for the layer.

includeGeometry

Controls if feature geometries are included in the export results. The default is 'true'.

xColumnName

Only applies to CSV exportFormat. The name of the field in the CSV file that will contain the x coordinate of exported point geometries. The default value is 'x'.

yColumnName

Only applies to CSV exportFormat. The name of the field in the CSV file that will contain the y coordinate of exported point geometries. The default value is 'y'.

A sample exportParameters JSON object is as follows:

1
2
3
4
5
{
   "layers" :[ {"id" : 0 },
               {"id" : 1, "where" : "POP1999 > 100000"}
             ]
}

Response Properties

The response object is described below.

PropertyDetails

type

The type of the resulting item.

size

The size of the resulting item.

jobId

The job ID of the export job.

exportItemId

The ID of the result item of the export.

serviceItemId

The ID of the service item that was exported.

exportFormat

The format of the export.

JSON Response Syntax

1
2
3
4
5
6
7
8
{
    "type":<type of the exported  item>,
    "size":<size of the exported item>,
    "jobId":<jobId for the export job>
    "exportItemId":<id of the exported item that is created>,
    "serviceItemId": <id  of the hosted feature service item that was exported>,
    "exportFormat": <exportFormat>
}

JSON Response Example

1
2
3
4
5
6
7
8
{
    "type" : "Shapefile",
    "size" : 656325,
    "jobId" : "340f0f98-a5d2-48c0-b8ab-a1b418529024",
    "exportItemId" : "4e37b0b8550a40709f02a695cd9fc4fc",
    "serviceItemId":"2e39b0b9550a40709f02a697cd9fc4fb",
    "exportFormat" : "Shapefile"
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close