Skip to main content
Skip table of contents

Stored Search API

Get List of Stored Searches

CODE
GET /data/search/saved

Parameters:

ParameterDescriptionParameter TypeData Type
formatOptional. Specify the data format to be returned.Query string

String:

  • JSON
  • XML
  • CSV

Response Formats: JSON (default), XML, CSV

 

Get A Specific Stored Search

This function will return the XML definition of a specified stored search.

CODE
GET /data/search/saved/{ID}

Parameters:

ParameterDescriptionParameter TypeData Type
IDThe unique ID of the stored search. These will be returned in the list of stored searchesPathstring

Response Formats: XML

 

Create A Stored Search

This function will allow you to create a new stored search by posting XML to the XNAT search API.

CODE
POST /data/search/saved

Parameters:

ParameterDescriptionParameter TypeData Type
modelThe XML structure of the stored search you want to create. See https://flywheelio.atlassian.net/wiki/spaces/XNAT17/pages/2507548171 for notes on formatting.BodyXML

 

Update A Stored Search

This function will allow you to post an updated XML definition to an already-created stored search.

CODE
PUT /data/search/saved/{ID}

Parameters:

ParameterDescriptionParameter TypeData Type
IDThe unique ID of the stored search. These will be returned in the list of stored searchesPathstring
modelThe XML structure of the stored search you want to create. See https://flywheelio.atlassian.net/wiki/spaces/XNAT17/pages/2507548171 for notes on formatting.bodyXML

 

Get Results From A Stored Search

CODE
GET /data/search/saved/{ID}/results

Parameters:

ParameterDescriptionParameter TypeData Type
IDThe unique ID of the stored search. These will be returned in the list of stored searchesPathstring
guiStyleOptional. If this query parameter is set to true, the information returned will be run through the same formatting that information in the GUI is normally run through. This means that the results of the REST call will have the same columns and column headings as the table displayed in the GUI when the saved search is executed.Query stringboolean
formatOptional. Specify the data format to be returned.Query string

String:

  • HTML
  • JSON
  • XML
  • CSV

Response Formats: XML (default), HTML, JSON, CSV

 

 

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.