---
updatedAt: 2026-01-28T20:52:08.000Z
agentTools:
  projectIndex: https://developer.vyasa.com/llms.txt
---

# Call Certara LLM to retrieve evidence from a query based on previously embedded documents

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Layar API Documentation",
    "version": "1.927.8",
    "contact": {
      "name": "Certara AI Support",
      "email": "AI-Support@Certara.com",
      "url": "https://vyasa.readme.io/"
    }
  },
  "servers": [
    {
      "url": "BASE_PATH"
    }
  ],
  "paths": {
    "/layar/gpt/retrieval/search": {
      "post": {
        "operationId": "search",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GptRetrievalSearchCommand"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GptRetrievalSearchResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request"
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        },
        "summary": "Call Certara LLM to retrieve evidence from a query based on previously embedded documents",
        "tags": [
          "gpt"
        ]
      }
    }
  },
  "tags": [
    {
      "description": "GPT",
      "name": "gpt"
    }
  ],
  "components": {
    "schemas": {
      "GptRetrievalSearchResponse": {
        "title": "GptRetrievalSearchResponse",
        "type": "object",
        "properties": {
          "evidence": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "rawText": {
                  "type": "string"
                },
                "documentId": {
                  "type": "string"
                },
                "score": {
                  "type": "number",
                  "format": "float"
                },
                "scoreContribution": {
                  "type": "object",
                  "properties": {
                    "keyword": {
                      "type": "array",
                      "items": {
                        "type": "number",
                        "format": "float"
                      }
                    },
                    "vector": {
                      "type": "array",
                      "items": {
                        "type": "number",
                        "format": "float"
                      }
                    },
                    "rerankScore": {
                      "type": "array",
                      "items": {
                        "type": "number",
                        "format": "float"
                      }
                    }
                  }
                },
                "chunkId": {
                  "type": "string"
                },
                "documentType": {
                  "type": "string"
                },
                "expandedText": {
                  "type": "string"
                },
                "expandedScore": {
                  "type": "number",
                  "format": "float"
                }
              }
            }
          }
        }
      },
      "GptRetrievalSearchCommand": {
        "title": "GptRetrievalSearchCommand",
        "type": "object",
        "required": [
          "query"
        ],
        "properties": {
          "query": {
            "type": "string",
            "description": "Search query string. Required.",
            "example": "Find relevant documents about AI models."
          },
          "searchOperator": {
            "type": "string",
            "description": "Logical operator to combine search conditions (AND, OR)",
            "enum": [
              "AND",
              "OR"
            ],
            "default": "AND"
          },
          "retriever": {
            "type": "object",
            "properties": {
              "document": {
                "type": "object",
                "properties": {
                  "indexName": {
                    "type": "string",
                    "description": "Optional name for the index, defaults to 'CGPTDocumentStore'.",
                    "example": "CGPTDocumentStore"
                  },
                  "lookupFilter": {
                    "type": "string",
                    "description": "Optional filter for document lookup, defaults to 'documentId'.",
                    "example": "documentId"
                  },
                  "reranker": {
                    "type": "boolean",
                    "default": true,
                    "description": "Optional flag to enable or disable reranker, defaults to true.",
                    "example": true
                  },
                  "numHits": {
                    "type": "integer",
                    "minimum": 10,
                    "description": "Number of hits to return, must be 10 or more.",
                    "example": 10
                  },
                  "heatRatio": {
                    "type": "number",
                    "format": "float",
                    "minimum": 0.5,
                    "description": "Heat ratio for the query, must be 0.5 or higher.",
                    "example": 0.75
                  },
                  "enableSectioning": {
                    "type": "boolean",
                    "default": true,
                    "description": "Optional flag to enable or disable document sectioning, defaults to true.",
                    "example": true
                  },
                  "searchRatio": {
                    "type": "number",
                    "format": "float",
                    "minimum": 0,
                    "maximum": 1,
                    "description": "Search ratio for the query, must be greater than or equal to 0.0 and less than or equal to 1.0.",
                    "example": 0.8
                  },
                  "relevanceThreshold": {
                    "type": "number",
                    "format": "float",
                    "minimum": 0,
                    "maximum": 1,
                    "description": "Relevance threshold for the query, must be greater than or equal to 0.0 and less than or equal to 1.0.",
                    "example": 0.6
                  }
                },
                "description": "Document retriever settings. Optional."
              },
              "table": {
                "type": "object",
                "properties": {
                  "indexName": {
                    "type": "string",
                    "description": "Optional name for the index, defaults to 'CGPTDocumentStore'."
                  },
                  "lookupFilter": {
                    "type": "string",
                    "description": "Optional filter for document lookup, defaults to 'documentId'."
                  },
                  "reranker": {
                    "type": "boolean",
                    "default": true,
                    "description": "Optional flag to enable or disable reranker, defaults to true."
                  },
                  "numHits": {
                    "type": "integer",
                    "minimum": 10,
                    "description": "Number of hits to return, must be 10 or more."
                  },
                  "heatRatio": {
                    "type": "number",
                    "format": "float",
                    "minimum": 0.5,
                    "description": "Heat ratio for the query, must be 0.5 or higher."
                  },
                  "enableSectioning": {
                    "type": "boolean",
                    "default": false,
                    "description": "Document sectioning is disabled for Tables."
                  },
                  "searchRatio": {
                    "type": "number",
                    "format": "float",
                    "minimum": 0,
                    "maximum": 1,
                    "description": "Search ratio for the query, must be greater than or equal to 0.0 and less than or equal to 1.0."
                  },
                  "relevanceThreshold": {
                    "type": "number",
                    "format": "float",
                    "minimum": 0,
                    "maximum": 1,
                    "default": 0.5,
                    "description": "Relevance threshold for the query, must be greater than or equal to 0.0 and less than or equal to 1.0."
                  }
                }
              }
            }
          },
          "searchFilters": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "provider": {
                  "type": "string",
                  "description": "Identifier for the data provider.",
                  "example": "sandbox.certara.ai"
                },
                "documentId": {
                  "type": "string",
                  "description": "Unique ID of the document.",
                  "example": "AZUqZX4vs4YY7lBzj0ks"
                },
                "savedListId": {
                  "type": "string",
                  "description": "ID of a saved list to filter search results.",
                  "example": "AZIrIZTW-iDiL2Yfx2xw"
                },
                "searchConditions": {
                  "type": "array",
                  "description": "List of search conditions to filter documents by metadata",
                  "items": {
                    "type": "object",
                    "properties": {
                      "field": {
                        "type": "string",
                        "description": "The metadata field to filter on",
                        "example": "author"
                      },
                      "operator": {
                        "type": "string",
                        "description": "The operator to use for the comparison",
                        "example": "=="
                      },
                      "value": {
                        "type": "string",
                        "description": "The value to compare against",
                        "example": "John Doe"
                      }
                    }
                  }
                }
              }
            }
          },
          "documentType": {
            "type": "string",
            "enum": [
              "DOCUMENT",
              "TABLE"
            ],
            "description": "Specifies whether the search should be performed on documents or tables.",
            "example": "DOCUMENT"
          }
        }
      }
    },
    "securitySchemes": {
      "oAuth2ClientCredentials": {
        "type": "oauth2",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "CONNECT_API_URL/oauth/token",
            "scopes": {}
          }
        }
      }
    }
  },
  "security": [
    {
      "oAuth2ClientCredentials": []
    }
  ]
}
```