Search API
  • Globus Search
  • Overview
  • API Usage & Basics
  • Ingest
  • Query
  • Types, Type Detection, and Schemas
  • Error Handling
  • API Reference
    • Batch Delete by Subject
    • Create or Update Entry
    • Delete by Query
    • Delete by Subject
    • Entry Delete
    • Entry Show
    • Index Create
    • Index Delete
    • Index List
    • Index Reopen
    • Index Show
    • Index Update
    • Ingest
    • Query - GET
    • Query - POST
    • Role Create
    • Role Delete
    • Role List
    • Scroll Query
    • Subject Show
    • Task List
    • Task Show
  • Guides
    • Geospatial Search
    • Role Based Filtering
    • Searchable Files
  • Globus Search Limits
  • API Change History
Skip to main content
Globus Docs
  • Getting Started
    Getting Started

    Getting Started and Tutorial docs cover how to perform some activity or provide an introduction to a feature. They are not comprehensive, but help you get started with Globus or with new Globus features.

    • Users
    • Admins
    • Developers
  • Reference
    Reference
    • Service
      • Auth
      • Groups
      • Transfer
      • Timers
      • Flows
      • Compute
      • Search
    • Agents
      • Globus Connect Server
      • GCS CLI
      • Globus Connect Personal
      • Globus Compute
    • SDK
      • Python
      • JS
    • Clients
      • CLI
    • Security and Compliance
      • Product Security
      • Privacy
      • Solutions for Sensitive Data
      • FAQs
  • Solutions & Guides
    Solutions & Guides

    Find practical approaches for leveraging Globus in research environments, integrating with platforms, and building science gateways. Access hands-on guides, integration instructions, and real-world scenarios for advanced usage.

    • Portals/Science Gateways
    • Guides
  • Support
    Support

    Find answers to frequently asked questions, connect with the community by joining our mailing lists, or reach out directly to Globus support.

    • FAQs
    • Mailing Lists
    • Contact Us
    • Check Support Tickets
  • Site Search
  1. Home
  2. Globus Services
  3. Globus Search
  4. API Usage & Basics

API Usage & Basics

Table of Contents
  • 1. Communicating with Globus Search
    • 1.1. URLs
  • 2. Authentication & Authorization
    • 2.1. Authorization Header
    • 2.2. Scopes
    • 2.3. Permissions in Search

The Full API Reference covers all API methods.

It details the request methods, authentication and authorization requirements, and response formats for every supported operation.

All of that documentation has these components as its basis:

1. Communicating with Globus Search

Globus Search is a web API which communicates over the HTTP protocol using a RESTful data model.

1.1. URLs

The Search API is reached at https://search.api.globus.org/

URLs and URIs in this documentation will usually omit this piece, so the text

GET /foo/bar

should be interpreted as referring to an HTTP GET request against

https://search.api.globus.org/foo/bar

1.1.1. Globus Preview URL

In the Globus Preview environment, the Search API can be found at https://search.api.preview.globus.org.

2. Authentication & Authorization

Some features of Search don’t have any authorization or authentication requirements. These can be accessed over HTTPS with no credentials.

API methods are which are documented as requiring authentication must be authenticated with a Globus Auth token. They will document the scopes which they need.

2.1. Authorization Header

Globus Search authorizes access with Globus Auth. It therefore requires that any authenticated calls be made with a bearer Authorization header:

Authorization: Bearer <token_string>

The token string is an Access Token provided via Globus Auth.

2.2. Scopes

Access tokens for Globus Search have one or more of the following scopes:

Name Full Scope String Definition

ingest

urn:globus:auth:scope:search.api.globus.org:ingest

The token authorizes the call to write data into Globus Search and to perform task management operations.

search

urn:globus:auth:scope:search.api.globus.org:search

The token authorizes the call to query data from Globus Search.

all

urn:globus:auth:scope:search.api.globus.org:all

Access all capabilities of the Globus Search service.

2.3. Permissions in Search

Globus Search evaluates and enforces permissions after successful authentication. In particular, a user may be

  • An admin of an index

  • A writer of an index

  • A member of the visible_to list of a document

These permissions are all evaluated against the linked identities and Globus Group memberships of a user.

  • Globus Search
  • Overview
  • API Usage & Basics
  • Ingest
  • Query
  • Types, Type Detection, and Schemas
  • Error Handling
  • API Reference
    • Batch Delete by Subject
    • Create or Update Entry
    • Delete by Query
    • Delete by Subject
    • Entry Delete
    • Entry Show
    • Index Create
    • Index Delete
    • Index List
    • Index Reopen
    • Index Show
    • Index Update
    • Ingest
    • Query - GET
    • Query - POST
    • Role Create
    • Role Delete
    • Role List
    • Scroll Query
    • Subject Show
    • Task List
    • Task Show
  • Guides
    • Geospatial Search
    • Role Based Filtering
    • Searchable Files
  • Globus Search Limits
  • API Change History
© 2010- The University of Chicago Legal Privacy Accessibility