---
title: "Get the Globus collection details for a data release."
method: GET
path: "/datacatalog/api/data-release/{id}/files/collection-info"
tags: ["Data Release"]
---

# Get the Globus collection details for a data release.

`GET /datacatalog/api/data-release/{id}/files/collection-info`

## Request

- Base URL: `https://data.usgs.gov` (the document declares no server; this is the origin it was published from)
- URL: `https://data.usgs.gov/datacatalog/api/data-release/{id}/files/collection-info`
- Auth: OAuth 2
  - Authorization code: `https://auth.globus.org/v2/oauth2/authorize?scope=openid`
  - Token URL: `https://data.usgs.gov/datacatalog/api/auth/login`

Get the Globus collection details for a data release.

Data release files are stored in a Globus collection under a directory named
for the data release ID. This endpoint returns the identifiers needed to
reach those files directly, without going through the Horizon API:

- `collection_id`: The ID of the Globus collection holding the release's
  files. Use it as the source or destination collection in Globus tooling,
  or to request the collection's HTTPS scope
  (`https://auth.globus.org/scopes/<collection_id>/https`).
- `https_server`: The collection's base HTTPS URL. An individual file can be
  requested at `<https_server>/<release_id>/<file_name>` (or
  `<https_server>/<release_id>/<component_name>/<file_name>` for a component
  file) with a Globus HTTPS access token for the collection. This is null if
  the collection does not support HTTPS access.

The requesting user must have write access to the data release.

.. code-block::

    {
        "success": true,
        "message": "Request processed successfully",
        "data": {
            "collection_id": "<Globus collection ID>",
            "https_server": "https://g-1a2b3c.data.globus.org"
        }
    }

:param id: The ID of the data release.
:param token: A valid bearer token for the user.
:returns: A :class:`GetCollectionInfoResponse` whose `data` contains the
    `collection_id` and `https_server`.
:raises NotFoundException: If the data release does not exist (404).
:raises ForbiddenException: If the user lacks write access to the data
    release (403).

## Path parameters

- `id` string, required

## Response `200`

Successful Response

- GetCollectionInfoResponse
  - `success` boolean, required: A boolean (true/false) indicating if the request was successful.
  - `message` union, required: Descriptive text providing context or further information about the request.
    - 'Created' | 'A component with componentName "{componentName}" already exists in this data release. Please provide a unique componentName.' | 'Deleted' | 'Deletion error' | 'Unable to delete component.' | 'Data release contains components. All components must be deleted before the data release can be deleted.' | 'DOI assigned to Data Release' | 'An entity_id is missing for some or all creators or contributors. Please add any missing entity_id values and try again.' | 'The useForPreview value may only be set to True for .png or .jpg files.' | 'The Globus Search query was not valid. See https://docs.globus.org/api/search/reference/post_query/ for query syntax.' | 'Globus transfer request successfully submitted' | 'A transfer with identical paths has not yet completed. The current transfer may be terminated in the Globus console or contact ask-sdm@usgs.gov for assistance.' | 'Invalid scopes found for transfer. Please re-authenticated and retry transfer.' | 'A transfer path cannot include a directory.' | 'Duplicate filenames not allowed for transfer.' | 'The source endpoint for the Globus transfer was unavailable. Please confirm source Globus collection is available and try again.' | 'A file name cannot contain any of the following characters: < > : " / \ | ? *. On Microsoft Windows, file paths must be formatted like /C/Users/username/filename.csv.' | 'On Microsoft Windows, file paths must be formatted like /C/Users/username/filename.csv.' | 'An unknown error occurred during the transfer. Please try again later or contact ask-sdm@usgs.gov for assistance' | 'This task cannot be found. Please check the task ID.' | 'Internal server error' | 'Invalid schema' | 'File limit reached in collection.' | 'Metadata file not selected. Select a metadata file before performing index files.' | 'Metadata file not found. Please verify metadata file exists in the collection.' | 'Not authenticated' | 'Not Authorized' | 'Item not found' | 'Permissions updated' | 'Some permission changes could not be applied. See the errors in the response for details.' | 'Request processed successfully' | 'Delete not allowed for published releases' | 'Search not avaiable for data releases with more than 10000 components.' | 'Unable to update status at this time. Contact ask-sdm@usgs.gov for assistance.' | 'Updated' | 'User provided groups must grant manager permission to Horizon identity.' | 'User provided groups must not grant admin permission to the Horizon identity.'
    - string
  - `data` CollectionInfoResponse, required: The Globus collection details for a data release.
    - `collection_id` string, required: The ID of the Globus collection holding the data release files.
    - `https_server` string, nullable: The base HTTPS URL for the collection, e.g. "https://g-1a2b3c.data.globus.org". Files may be requested directly from this server at "<https_server>/<release_id>/<file_name>". Null if the collection does not support HTTPS access.

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/usgs/apis/usgs-science-data-catalog-api-documentation.md) - [All operations](https://skmtc.dev/usgs/apis/usgs-science-data-catalog-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/usgs/apis/usgs-science-data-catalog-api-documentation/revisions/f5f6a07ba13f?raw)