Confluence Retirement

In an effort to consolidate USGS hosted Wikis, myUSGS’ Confluence service is scheduled for retirement on January 27th, 2023. 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.

RESTful Web Services for People and Organizations

titleHTTP Headers

When requesting content from ScienceBase services, use the Accept header to request a format such as

Accept: application/json

And when sending content in the body of a POST or PUT, use the Content-Type header to tell the server the format of the incoming content and add an Accept header to specify what format should be returned.

Content-Type: application/json
Accept: application/json

Older versions of some ScienceBase services conflated Content-Type and Accept headers. So some services have worked with only specifying one of these headers for both submitted and requested formats. Do not rely on that going forward. Use Accept to request a format from a service and Content-Type to describe data being sent to the service. POST and PUT methods involve both sending and receiving data so both headers should be used.



These services are being used by production applications such as ScienceBase-Catalog and are still an active work in progress. JSON (ScienceBase-JSON) is the preferred format, while there is an XML format, at least for Read operations, it's future is uncertain.  This current ScienceBase XML format might be replaced with a standard like ATOM.  To get ScienceBase-JSON make sure you add the header Accept: application/json or the query param format=json to the request.