Esri

Esri Portal API

Portal items, users, groups, and organizational management

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /portals/self Get my organization's portal information · Get portal information #
Ask an LLM
“How do I see my ArcGIS organization's portal name, description and thumbnail?”
“What resources and helper services does my organization's portal expose?”
Tell an agent
Show me our organization's portal details.
Fetch the portal self information in {f} format.
GET /community/users/{username} Get a portal user's profile · Get user profile #
Ask an LLM
“Can I look up the profile of a specific member of our ArcGIS organization?”
“What profile details are returned for a portal user by username?”
Tell an agent
Show the profile for user {username}.
Get the community profile of {username} as {f}.
GET /content/users/{username}/items List content items a user owns · List user content items #
Ask an LLM
“How do I list all the maps, layers and apps a particular user owns?”
“Can I page through and sort one user's content items?”
Tell an agent
List the items owned by {username}.
Show {num} of {username}'s items starting at {start}, sorted by {sortField} {sortOrder}.
GET /content/items/{itemId} Get a portal item's details · Get portal item #
Ask an LLM
“What information can I get about a single map or layer item by its ID?”
“Which call returns the metadata of one specific portal item?”
Tell an agent
Get the details of portal item {itemId}.
Fetch item {itemId} in {f} format.
GET /search Search portal items, groups and users · Search portal content #
Ask an LLM
“Can I search across the whole portal for feature services owned by a certain person?”
“What query syntax does ArcGIS portal search accept for filtering items, groups and users?”
Tell an agent
Search the portal for {q}.
Run portal search {q} and return {num} results sorted by {sortField} {sortOrder}.

Documentation

📖
Documentation
https://developers.arcgis.com/documentation/
📖
Authentication
https://developers.arcgis.com/documentation/security-and-authentication/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/esri/refs/heads/main/openapi/esri-portal-api-openapi.yml

Other Resources

🔗
Portal
https://developers.arcgis.com/
🔗
Reference
https://developers.arcgis.com/rest/

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/esri:esri-portal-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

esri-portal-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: ESRI ArcGIS Platform Portal API
  description: ESRI ArcGIS Platform REST API for sharing, managing, and accessing GIS content including feature services, maps, layers, users, and portal items. The API enables geospatial data management, spatial analysis, geocoding, routing, and organizational administration for ArcGIS Online and ArcGIS Enterprise deployments.
  version: 1.0.0
  contact:
    name: ESRI Developer Support
    url: https://community.esri.com/t5/developers/ct-p/developers
  license:
    name: Esri Master Agreement
    url: https://www.esri.com/en-us/legal/terms/master-agreement
servers:
- url: https://www.arcgis.com/sharing/rest
  description: ArcGIS Online production
- url: https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer
  description: ArcGIS Geocoding Service
- url: https://route.arcgis.com/arcgis/rest/services
  description: ArcGIS Routing Service
- url: https://places-api.arcgis.com/arcgis/rest/services/v1
  description: ArcGIS Places Service
security:
- ApiKeyAuth: []
- OAuth2:
  - openid
tags:
- name: Portal
  description: Portal items, users, groups, and organizational management
paths:
  /portals/self:
    get:
      operationId: getPortalSelf
      summary: Get portal information
      description: Returns information about the organization's portal including available resources, helpers, and members. The response includes information about the portal's name, description, and thumbnail.
      tags:
      - Portal
      parameters:
      - name: f
        in: query
        required: false
        schema:
          type: string
          enum:
          - json
          - pjson
          - html
          default: json
        description: Output format
      - name: token
        in: query
        required: false
        schema:
          type: string
        description: Authentication token (alternative to Authorization header)
      responses:
        '200':
          description: Portal information returned successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Portal'
        '401':
          description: Unauthorized – valid token required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /community/users/{username}:
    get:
      operationId: getUser
      summary: Get user profile
      description: Returns the profile information of a specified user within the portal organization.
      tags:
      - Portal
      parameters:
      - name: username
        in: path
        required: true
        schema:
          type: string
        description: Username of the ArcGIS Online user
      - name: f
        in: query
        schema:
          type: string
          enum:
          - json
          - pjson
          default: json
      responses:
        '200':
          description: User profile returned
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/User'
        '404':
          description: User not found
  /content/users/{username}/items:
    get:
      operationId: getUserItems
      summary: List user content items
      description: Returns items owned by the specified user. Supports pagination, sorting, and filtering.
      tags:
      - Portal
      parameters:
      - name: username
        in: path
        required: true
        schema:
          type: string
      - name: num
        in: query
        schema:
          type: integer
          default: 10
          maximum: 100
        description: Number of results to return
      - name: start
        in: query
        schema:
          type: integer
          default: 1
        description: Index of the first entry in the result set (1-based)
      - name: sortField
        in: query
        schema:
          type: string
          enum:
          - created
          - modified
          - title
          - type
      - name: sortOrder
        in: query
        schema:
          type: string
          enum:
          - asc
          - desc
      - name: f
        in: query
        schema:
          type: string
          enum:
          - json
          - pjson
          default: json
      responses:
        '200':
          description: User items returned
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ItemCollection'
  /content/items/{itemId}:
    get:
      operationId: getItem
      summary: Get portal item
      description: Returns information about a specific portal item (map, layer, application, etc.).
      tags:
      - Portal
      parameters:
      - name: itemId
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier of the portal item
      - name: f
        in: query
        schema:
          type: string
          enum:
          - json
          - pjson
          default: json
      responses:
        '200':
          description: Item information returned
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Item'
        '404':
          description: Item not found
  /search:
    get:
      operationId: searchPortal
      summary: Search portal content
      description: Searches for portal items, groups, and users using ArcGIS query syntax. Supports spatial, temporal, and attribute filtering.
      tags:
      - Portal
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
        description: Query string using ArcGIS search syntax (e.g., "type:Feature Service owner:jsmith")
      - name: num
        in: query
        schema:
          type: integer
          default: 10
          maximum: 100
      - name: start
        in: query
        schema:
          type: integer
          default: 1
      - name: sortField
        in: query
        schema:
          type: string
          enum:
          - title
          - created
          - modified
          - type
          - relevance
      - name: sortOrder
        in: query
        schema:
          type: string
          enum:
          - asc
          - desc
      - name: f
        in: query
        schema:
          type: string
          enum:
          - json
          - pjson
          default: json
      responses:
        '200':
          description: Search results returned
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SearchResults'
components:
  schemas:
    ItemCollection:
      type: object
      properties:
        total:
          type: integer
        start:
          type: integer
        num:
          type: integer
        nextStart:
          type: integer
        items:
          type: array
          items:
            $ref: '#/components/schemas/Item'
    Portal:
      type: object
      properties:
        id:
          type: string
          description: Portal organization ID
        name:
          type: string
        description:
          type: string
        url:
          type: string
          format: uri
        thumbnail:
          type: string
        culture:
          type: string
          description: Default language/locale (e.g., "en")
        region:
          type: string
        created:
          type: integer
          description: Creation timestamp (milliseconds since epoch)
        modified:
          type: integer
    Item:
      type: object
      properties:
        id:
          type: string
        owner:
          type: string
        title:
          type: string
        type:
          type: string
          description: Item type (e.g., "Feature Service", "Web Map", "CSV")
        typeKeywords:
          type: array
          items:
            type: string
        description:
          type: string
        snippet:
          type: string
        thumbnail:
          type: string
        url:
          type: string
          format: uri
        tags:
          type: array
          items:
            type: string
        created:
          type: integer
        modified:
          type: integer
        numViews:
          type: integer
        size:
          type: integer
        access:
          type: string
          enum:
          - private
          - shared
          - org
          - public
        extent:
          type: array
          items:
            type: array
            items:
              type: number
          description: Bounding box [[xmin,ymin],[xmax,ymax]]
    GroupRef:
      type: object
      properties:
        id:
          type: string
        title:
          type: string
        access:
          type: string
    SearchResults:
      type: object
      properties:
        query:
          type: string
        total:
          type: integer
        start:
          type: integer
        num:
          type: integer
        nextStart:
          type: integer
        results:
          type: array
          items:
            $ref: '#/components/schemas/Item'
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            details:
              type: array
              items:
                type: string
    User:
      type: object
      properties:
        username:
          type: string
        fullName:
          type: string
        firstName:
          type: string
        lastName:
          type: string
        email:
          type: string
          format: email
        description:
          type: string
        role:
          type: string
          enum:
          - org_admin
          - org_publisher
          - org_user
          - account_admin
        level:
          type: string
        created:
          type: integer
        modified:
          type: integer
        groups:
          type: array
          items:
            $ref: '#/components/schemas/GroupRef'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: query
      name: token
      description: ArcGIS API key or token
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://www.arcgis.com/sharing/rest/oauth2/authorize
          tokenUrl: https://www.arcgis.com/sharing/rest/oauth2/token
          scopes:
            openid: OpenID Connect identity
            urn:arcgis:scope:root: Full access to ArcGIS Online
externalDocs:
  description: ArcGIS REST API Reference
  url: https://developers.arcgis.com/rest/