Confluence Retirement

In an effort to consolidate USGS hosted Wikis, the myUSGS Confluence service is targeted for retirement on January 28, 2022. The official USGS Wiki and collaboration space is now SharePoint. Please migrate existing spaces and content to the SharePoint platform and remove it from Confluence at your earliest convenience. If you need any additional information or have any concerns about this change, please contact Thank you for your prompt attention to this matter.

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Organizations Collection Resource

Search for organizations.

Query Form


Query Parameters

name(text)an exact match on (the record name).
q(text)full text search on all fields
activetrue, false (boolean)limit results to only parties with the active flag set to true or false
emailemail addresssearch by email address
max(integer)maximimun number of records to return
offset(integer)skip the first N records, use this in combination with max page through results
formatjson, html, ....specify the output format to be JSON or HTML. This can also be accomplished with an 'Accepts' header.
sortname, displayName, ...the name of the field to sort by. When not specified, the results are sort by search score. Sorting by fields other than search score can negatively impact performance.
orderasc, descsort in ascending or descending order

Query Examples

GET: Search for Organizations

Code Block<keywords>


Code Block
GET directory/organizations?q=bio HTTP/1.1
Accept: application/json


Code Block
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8

         "name":"Biological Carbon Sequestration",
         "displayText":"Biological Carbon Sequestration",
         "name":"Office of the Chief Scientist for Ecosystems",
         "displayText":"Office of the Chief Scientist for Ecosystems",