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",
    "sample_query": {
        "fields": [
            {
                "argument_fields": [
                    {
                        "contextual_type": "String",
                        "data_type": "String",
                        "localized_name": "String",
                        "semantic_type": "String"
                    }
                ],
                "contextual_type": "String",
                "data_type": "String",
                "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"
                        },
                        "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"
                            },
                            "parameters": [
                                "String"
                            ]
                        },
                        "operator": {
                            "connective": "String <one of: AND, OR, NOT>",
                            "data_type": "String",
                            "localized_name": "String",
                            "name": "String"
                        },
                        "parameters": [
                            "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"
                            },
                            "parameters": [
                                "String"
                            ]
                        }
                    },
                    "operator": {
                        "connective": "String <one of: AND, OR, NOT>",
                        "data_type": "String",
                        "localized_name": "String",
                        "name": "String"
                    },
                    "parameters": [
                        "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"
                            },
                            "parameters": [
                                "String"
                            ]
                        },
                        "operator": {
                            "connective": "String <one of: AND, OR, NOT>",
                            "data_type": "String",
                            "localized_name": "String",
                            "name": "String"
                        },
                        "parameters": [
                            "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"
                            },
                            "parameters": [
                                "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"
                        },
                        "parameters": [
                            "String"
                        ]
                    },
                    "operator": {
                        "connective": "String <one of: AND, OR, NOT>",
                        "data_type": "String",
                        "localized_name": "String",
                        "name": "String"
                    },
                    "parameters": [
                        "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"
                        },
                        "parameters": [
                            "String"
                        ]
                    }
                },
                "operator": {
                    "connective": "String <one of: AND, OR, NOT>",
                    "data_type": "String",
                    "localized_name": "String",
                    "name": "String"
                },
                "parameters": [
                    "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"
                        },
                        "parameters": [
                            "String"
                        ]
                    },
                    "operator": {
                        "connective": "String <one of: AND, OR, NOT>",
                        "data_type": "String",
                        "localized_name": "String",
                        "name": "String"
                    },
                    "parameters": [
                        "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"
                        },
                        "parameters": [
                            "String"
                        ]
                    }
                }
            }
        ],
        "range": {
            "limit": 42,
            "offset": 42
        },
        "sorts": [
            {
                "direction": "String <one of: ASC, DESC>",
                "field": {
                    "argument_fields": [
                        {
                            "contextual_type": "String",
                            "data_type": "String",
                            "localized_name": "String",
                            "semantic_type": "String"
                        }
                    ],
                    "contextual_type": "String",
                    "data_type": "String",
                    "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"
                            },
                            "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"
                                },
                                "parameters": [
                                    "String"
                                ]
                            },
                            "operator": {
                                "connective": "String <one of: AND, OR, NOT>",
                                "data_type": "String",
                                "localized_name": "String",
                                "name": "String"
                            },
                            "parameters": [
                                "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"
                                },
                                "parameters": [
                                    "String"
                                ]
                            }
                        },
                        "operator": {
                            "connective": "String <one of: AND, OR, NOT>",
                            "data_type": "String",
                            "localized_name": "String",
                            "name": "String"
                        },
                        "parameters": [
                            "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"
                                },
                                "parameters": [
                                    "String"
                                ]
                            },
                            "operator": {
                                "connective": "String <one of: AND, OR, NOT>",
                                "data_type": "String",
                                "localized_name": "String",
                                "name": "String"
                            },
                            "parameters": [
                                "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"
                                },
                                "parameters": [
                                    "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"
                }
            }
        ]
    }
}