GET /dynamic_search/schemas/{name}

Gets the list of all schemas available to the user.

Gets a SchemaDTO describing the Schema the user requested.

Table 1. GET /dynamic_search/schemas/{name} resource details
MIME Type

application/json

Table 2. GET /dynamic_search/schemas/{name} request parameter details
Parameter Type Optionality Data Type MIME Type Description

name

path

Required

String

text/plain

null

fields

query

Optional

String

text/plain

Optional - Use this parameter to specify which fields you would like to get back in the response. Fields that are not named are excluded. Specify subfields in brackets and multiple fields in the same object are separated by commas.

Table 3. GET /dynamic_search/schemas/{name} response codes
HTTP Response Code Unique Code Description

200

The Schema the user requested was retrieved.

404

1011

No schema with that name was found

500

1010

null

Response Description

The Schema the user requested.
  • name - String - The unique name of the data area represented by this schema.
  • description - String - A description of the schema.
  • sample_query - A legal sample query that returns data from this schema.

Response Sample


[
  {
    "description": "String",
    "name": "String",
    "query": {
      "fields": [
        {
          "argument_fields": [
            {
              "contextual_type": "String",
              "data_type": "String",
              "localized_name": "String",
              "semantic_type": "String"
            }
          ],
          "contextual_type": "String",
          "data_type": "String",
          "filter": {
            "argument": "Object",
            "left_filter": {
              "argument": "Object",
              "left_filter": {
                "argument": "Object",
                "operator": {
                  "connective": "String <one of: AND, OR, NOT>",
                  "data_type": "String",
                  "localized_name": "String",
                  "name": "String"
                },
                "parameter": "String"
              },
              "operator": {
                "connective": "String <one of: AND, OR, NOT>",
                "data_type": "String",
                "localized_name": "String",
                "name": "String"
              },
              "parameter": "String",
              "right_filter": {
                "argument": "Object",
                "operator": {
                  "connective": "String <one of: AND, OR, NOT>",
                  "data_type": "String",
                  "localized_name": "String",
                  "name": "String"
                },
                "parameter": "String"
              }
            },
            "operator": {
              "connective": "String <one of: AND, OR, NOT>",
              "data_type": "String",
              "localized_name": "String",
              "name": "String"
            },
            "parameter": "String",
            "right_filter": {
              "argument": "Object",
              "left_filter": {
                "argument": "Object",
                "operator": {
                  "connective": "String <one of: AND, OR, NOT>",
                  "data_type": "String",
                  "localized_name": "String",
                  "name": "String"
                },
                "parameter": "String"
              },
              "operator": {
                "connective": "String <one of: AND, OR, NOT>",
                "data_type": "String",
                "localized_name": "String",
                "name": "String"
              },
              "parameter": "String",
              "right_filter": {
                "argument": "Object",
                "operator": {
                  "connective": "String <one of: AND, OR, NOT>",
                  "data_type": "String",
                  "localized_name": "String",
                  "name": "String"
                },
                "parameter": "String"
              }
            }
          },
          "function": {
            "aggregate": true,
            "argument_types": [
              {
                "position": 42,
                "type": "String"
              }
            ],
            "localized_name": "String",
            "name": "String",
            "return_data_type": "String"
          },
          "localized_name": "String",
          "semantic_type": "String"
        }
      ],
      "filters": [
        {
          "argument": {
            "argument_fields": [
              {
                "contextual_type": "String",
                "data_type": "String",
                "localized_name": "String",
                "semantic_type": "String"
              }
            ],
            "contextual_type": "String",
            "data_type": "String",
            "filter": "Object",
            "function": {
              "aggregate": true,
              "argument_types": [
                {
                  "position": 42,
                  "type": "String"
                }
              ],
              "localized_name": "String",
              "name": "String",
              "return_data_type": "String"
            },
            "localized_name": "String",
            "semantic_type": "String"
          },
          "left_filter": {
            "argument": {
              "argument_fields": [
                {
                  "contextual_type": "String",
                  "data_type": "String",
                  "localized_name": "String",
                  "semantic_type": "String"
                }
              ],
              "contextual_type": "String",
              "data_type": "String",
              "filter": "Object",
              "function": {
                "aggregate": true,
                "argument_types": [
                  {
                    "position": 42,
                    "type": "String"
                  }
                ],
                "localized_name": "String",
                "name": "String",
                "return_data_type": "String"
              },
              "localized_name": "String",
              "semantic_type": "String"
            },
            "left_filter": {
              "argument": {
                "argument_fields": [
                  {
                    "contextual_type": "String",
                    "data_type": "String",
                    "localized_name": "String",
                    "semantic_type": "String"
                  }
                ],
                "contextual_type": "String",
                "data_type": "String",
                "filter": "Object",
                "function": {
                  "aggregate": true,
                  "argument_types": [
                    {
                      "position": 42,
                      "type": "String"
                    }
                  ],
                  "localized_name": "String",
                  "name": "String",
                  "return_data_type": "String"
                },
                "localized_name": "String",
                "semantic_type": "String"
              },
              "operator": {
                "connective": "String <one of: AND, OR, NOT>",
                "data_type": "String",
                "localized_name": "String",
                "name": "String"
              },
              "parameter": "String"
            },
            "operator": {
              "connective": "String <one of: AND, OR, NOT>",
              "data_type": "String",
              "localized_name": "String",
              "name": "String"
            },
            "parameter": "String",
            "right_filter": {
              "argument": {
                "argument_fields": [
                  {
                    "contextual_type": "String",
                    "data_type": "String",
                    "localized_name": "String",
                    "semantic_type": "String"
                  }
                ],
                "contextual_type": "String",
                "data_type": "String",
                "filter": "Object",
                "function": {
                  "aggregate": true,
                  "argument_types": [
                    {
                      "position": 42,
                      "type": "String"
                    }
                  ],
                  "localized_name": "String",
                  "name": "String",
                  "return_data_type": "String"
                },
                "localized_name": "String",
                "semantic_type": "String"
              },
              "operator": {
                "connective": "String <one of: AND, OR, NOT>",
                "data_type": "String",
                "localized_name": "String",
                "name": "String"
              },
              "parameter": "String"
            }
          },
          "operator": {
            "connective": "String <one of: AND, OR, NOT>",
            "data_type": "String",
            "localized_name": "String",
            "name": "String"
          },
          "parameter": "String",
          "right_filter": {
            "argument": {
              "argument_fields": [
                {
                  "contextual_type": "String",
                  "data_type": "String",
                  "localized_name": "String",
                  "semantic_type": "String"
                }
              ],
              "contextual_type": "String",
              "data_type": "String",
              "filter": "Object",
              "function": {
                "aggregate": true,
                "argument_types": [
                  {
                    "position": 42,
                    "type": "String"
                  }
                ],
                "localized_name": "String",
                "name": "String",
                "return_data_type": "String"
              },
              "localized_name": "String",
              "semantic_type": "String"
            },
            "left_filter": {
              "argument": {
                "argument_fields": [
                  {
                    "contextual_type": "String",
                    "data_type": "String",
                    "localized_name": "String",
                    "semantic_type": "String"
                  }
                ],
                "contextual_type": "String",
                "data_type": "String",
                "filter": "Object",
                "function": {
                  "aggregate": true,
                  "argument_types": [
                    {
                      "position": 42,
                      "type": "String"
                    }
                  ],
                  "localized_name": "String",
                  "name": "String",
                  "return_data_type": "String"
                },
                "localized_name": "String",
                "semantic_type": "String"
              },
              "operator": {
                "connective": "String <one of: AND, OR, NOT>",
                "data_type": "String",
                "localized_name": "String",
                "name": "String"
              },
              "parameter": "String"
            },
            "operator": {
              "connective": "String <one of: AND, OR, NOT>",
              "data_type": "String",
              "localized_name": "String",
              "name": "String"
            },
            "parameter": "String",
            "right_filter": {
              "argument": {
                "argument_fields": [
                  {
                    "contextual_type": "String",
                    "data_type": "String",
                    "localized_name": "String",
                    "semantic_type": "String"
                  }
                ],
                "contextual_type": "String",
                "data_type": "String",
                "filter": "Object",
                "function": {
                  "aggregate": true,
                  "argument_types": [
                    {
                      "position": 42,
                      "type": "String"
                    }
                  ],
                  "localized_name": "String",
                  "name": "String",
                  "return_data_type": "String"
                },
                "localized_name": "String",
                "semantic_type": "String"
              },
              "operator": {
                "connective": "String <one of: AND, OR, NOT>",
                "data_type": "String",
                "localized_name": "String",
                "name": "String"
              },
              "parameter": "String"
            }
          }
        }
      ],
      "range": {
        "limit": 42,
        "offset": 42
      },
      "sorts": [
        {
          "direction": "String",
          "field": {
            "argument_fields": [
              {
                "contextual_type": "String",
                "data_type": "String",
                "localized_name": "String",
                "semantic_type": "String"
              }
            ],
            "contextual_type": "String",
            "data_type": "String",
            "filter": {
              "argument": "Object",
              "left_filter": {
                "argument": "Object",
                "left_filter": {
                  "argument": "Object",
                  "operator": {
                    "connective": "String <one of: AND, OR, NOT>",
                    "data_type": "String",
                    "localized_name": "String",
                    "name": "String"
                  },
                  "parameter": "String"
                },
                "operator": {
                  "connective": "String <one of: AND, OR, NOT>",
                  "data_type": "String",
                  "localized_name": "String",
                  "name": "String"
                },
                "parameter": "String",
                "right_filter": {
                  "argument": "Object",
                  "operator": {
                    "connective": "String <one of: AND, OR, NOT>",
                    "data_type": "String",
                    "localized_name": "String",
                    "name": "String"
                  },
                  "parameter": "String"
                }
              },
              "operator": {
                "connective": "String <one of: AND, OR, NOT>",
                "data_type": "String",
                "localized_name": "String",
                "name": "String"
              },
              "parameter": "String",
              "right_filter": {
                "argument": "Object",
                "left_filter": {
                  "argument": "Object",
                  "operator": {
                    "connective": "String <one of: AND, OR, NOT>",
                    "data_type": "String",
                    "localized_name": "String",
                    "name": "String"
                  },
                  "parameter": "String"
                },
                "operator": {
                  "connective": "String <one of: AND, OR, NOT>",
                  "data_type": "String",
                  "localized_name": "String",
                  "name": "String"
                },
                "parameter": "String",
                "right_filter": {
                  "argument": "Object",
                  "operator": {
                    "connective": "String <one of: AND, OR, NOT>",
                    "data_type": "String",
                    "localized_name": "String",
                    "name": "String"
                  },
                  "parameter": "String"
                }
              }
            },
            "function": {
              "aggregate": true,
              "argument_types": [
                {
                  "position": 42,
                  "type": "String"
                }
              ],
              "localized_name": "String",
              "name": "String",
              "return_data_type": "String"
            },
            "localized_name": "String",
            "semantic_type": "String"
          }
        }
      ]
    }
  }
]