Elicit API

• query (required)

  string — The search query string

• corpus

  string, possible values: "elicit", "pubmed", default: "elicit" — Paper corpus to search. `elicit` (default) searches Elicit's full paper index; `pubmed` restricts to PubMed.

• filters

  object — Filters to narrow search results

  • excludeKeywords

    array — Keywords to exclude from results

    Items:

    string

  • hasPdf

    boolean — Only include papers with available PDFs

  • includeKeywords

    array — Keywords that must appear in the paper

    Items:

    string

  • maxEpochS

    integer — Maximum publication date as Unix epoch seconds

  • maxQuartile

    integer — Maximum journal quartile (1 = top 25%)

  • maxYear

    integer — Maximum publication year

  • minEpochS

    integer — Minimum publication date as Unix epoch seconds

  • minYear

    integer — Minimum publication year

  • pubmedOnly

    boolean — Only include papers from PubMed

  • retracted

    string, possible values: "exclude_retracted", "include_retracted", "only_retracted" — How to handle retracted papers. Defaults to exclude_retracted.

  • typeTags

    array — Filter by study type

    Items:

    string, possible values: "Review", "Meta-Analysis", "Systematic Review", "RCT", "Longitudinal"

• maxResults

  integer, default: 10 — Maximum number of results to return (default 10; schema range 1–10000). Your plan may impose a lower per-request cap; exceeding it returns 400 invalid_request. Search returns up to this many results without pagination.

• searchMode

  string, possible values: "semantic", "keyword", default: "semantic" — How to interpret `query`. `semantic` (default) runs Elicit's semantic search. `keyword` uses the corpus's native syntax: Lucene-style expressions for the Elicit index, PubMed query syntax for PubMed, or ClinicalTrials.gov advanced-search syntax for trials. Mutually exclusive with `filters` / `trialFilters` — put filter expressions into the query string in keyword mode.

Content-Type: application/json

Example:

{
  "papers": [
    {
      "elicitId": null,
      "title": "",
      "authors": [
        ""
      ],
      "year": null,
      "abstract": null,
      "doi": null,
      "pmid": null,
      "venue": null,
      "citedByCount": null,
      "urls": [
        ""
      ],
      "studyTypeTags": [
        ""
      ],
      "journalQuartile": null,
      "fullTextUrl": null
    }
  ],
  "warnings": [
    {
      "corpus": "elicit",
      "searchMode": "semantic",
      "message": "",
      "warningDetails": {
        "type": "",
        "messages": [
          ""
        ]
      }
    }
  ]
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

• query (required)

  string — The search query string

• maxResults

  integer, default: 10 — Maximum number of results to return (default 10; schema range 1–10000). Your plan may impose a lower per-request cap; exceeding it returns 400 invalid_request. Search returns up to this many results without pagination.

• searchMode

  string, possible values: "semantic", "keyword", default: "semantic" — How to interpret `query`. `semantic` (default) runs Elicit's semantic search. `keyword` uses the corpus's native syntax: Lucene-style expressions for the Elicit index, PubMed query syntax for PubMed, or ClinicalTrials.gov advanced-search syntax for trials. Mutually exclusive with `filters` / `trialFilters` — put filter expressions into the query string in keyword mode.

• trialFilters

  object — Clinical-trials filters (phase, recruitment status, results)

  • hasResults

    boolean — Only include trials that have posted results

  • phase

    array — Clinical trial phases to include

    Items:

    string, possible values: "NA", "EARLY_PHASE1", "PHASE1", "PHASE2", "PHASE3", "PHASE4"

  • recruitmentStatus

    array — Trial recruitment statuses to include

    Items:

    string, possible values: "ACTIVE_NOT_RECRUITING", "COMPLETED", "ENROLLING_BY_INVITATION", "NOT_YET_RECRUITING", "RECRUITING", "SUSPENDED", "TERMINATED", "WITHDRAWN", "AVAILABLE"

Content-Type: application/json

Example:

{
  "trials": [
    {
      "nctId": "NCT05646706",
      "title": "",
      "summary": null,
      "url": "https://clinicaltrials.gov/study/NCT05646706",
      "overallStatus": null,
      "phase": [
        ""
      ],
      "studyType": null,
      "enrollmentCount": null,
      "conditions": [
        ""
      ],
      "interventions": [
        ""
      ],
      "leadSponsor": null,
      "startDate": null,
      "primaryCompletionDate": null,
      "completionDate": null,
      "hasResults": null,
      "lastUpdatedYear": null
    }
  ],
  "warnings": [
    {
      "corpus": "elicit",
      "searchMode": "semantic",
      "message": "",
      "warningDetails": {
        "type": "",
        "messages": [
          ""
        ]
      }
    }
  ]
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

• researchQuestion (required)

  string — The research question to investigate. Elicit will search for relevant papers, screen them, and extract data to produce a structured report.

• isPublic

  boolean, default: false — Whether the report should be publicly accessible via its URL without authentication. Defaults to false.

• maxExtractPapers

  integer, default: 10 — Maximum number of papers to include in the final extraction table. Papers are screened for relevance before extraction. Defaults to 10.

• maxSearchPapers

  integer, default: 50 — Maximum number of papers to retrieve during the search phase. More papers means a more comprehensive but slower report. Defaults to 50.

• title

  string — Optional title for the report. If provided, Elicit will use this as the report title instead of generating one automatically from the research question.

Content-Type: application/json

Example:

{
  "type": "report",
  "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "url": "https://elicit.com/review/5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "isPublic": false,
  "links": {
    "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
    "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "type": "report",
  "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "executionStage": "gathering_sources",
  "url": "https://elicit.com/review/5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "isPublic": false,
  "result": {
    "title": "GLP-1 Receptor Agonists and Cardiovascular Outcomes: A Systematic Review",
    "summary": "This review analyzed 42 studies examining the cardiovascular effects of GLP-1 receptor agonists. The evidence suggests significant reductions in major adverse cardiovascular events (MACE), with semaglutide showing the strongest effect (HR 0.74, 95% CI 0.58-0.95)...",
    "reportBody": "# Introduction\n\nGLP-1 receptor agonists have emerged as...",
    "abstract": "This systematic review examines the cardiovascular effects of..."
  },
  "error": {
    "code": "",
    "message": ""
  },
  "pdfUrl": "https://s3.amazonaws.com/...",
  "docxUrl": "https://s3.amazonaws.com/...",
  "txtUrl": "https://s3.amazonaws.com/...",
  "bibUrl": "https://s3.amazonaws.com/...",
  "risUrl": "https://s3.amazonaws.com/...",
  "exportsStatus": "ready",
  "links": {
    "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
    "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

• researchQuestion (required)

  string — The research question the review is investigating.

• abstractScreening

  object — Abstract-stage screening. Supply `criteria`, `generate: true`, or both. Omit the field to skip.

  • criteria

    array — Explicit screening criteria.

    Items:

    • instructions (required)

      string — Plain-language instructions used to judge whether a paper meets this criterion

    • name (required)

      string — Short name for the criterion

  • depth

    string, possible values: "fast", "thorough", default: "thorough" — How thoroughly Elicit judges each abstract against your criteria. `thorough` applies the criteria in full, records the quotes behind each decision, and requires higher usage. `fast` returns decisions without supporting quotes and wrongly excludes more papers that met your criteria. The person you are acting for chooses this — do not decide it yourself. If they asked for a thorough screen, set `thorough`; if they asked for a fast one, set `fast`; if they have not said, ask them rather than picking silently. Omitting this field means `thorough`, so state your choice explicitly and tell the person which depth the review will use.

  • generate

    boolean, default: false — When true, Elicit generates additional screening criteria.

• dryRun

  boolean — Deprecated. Omit this field to create the review.

• extraction

  object — Extraction stage. Supply `questions`, `generate`, or both. Omit to skip extraction entirely.

  • generate

    boolean, default: false — When true, Elicit generates additional extraction columns.

  • questions

    array — Explicit extraction columns.

    Items:

    • instructions (required)

      string — Plain-language instructions describing what to extract

    • name (required)

      string — Column header for this extraction question

    • choices

      array — Optional fixed list of allowed answers. Omit for free-text extraction. When set, the model is constrained to one of these values.

      Items:

      string

  • useFigures

    boolean, default: false — Whether Elicit also reads figures and charts when answering your extraction questions, so it can pick up results that appear only in a figure — dose-response curves, Kaplan-Meier plots, anything whose answer lives in the image. It applies to every extraction column on every included paper, makes extraction slower, and requires higher usage. The person you are acting for chooses this — do not turn it on of your own accord. If they asked for figures, set it to `true` without hesitation; if they have not said, ask them. Omitting this field means figures are not read. Requires a plan that includes figure extraction.

• fulltextScreening

  object — Fulltext-stage screening. Supply `criteria`, `reuseAbstractCriteria: true`, or both. Requires `abstractScreening` to be present. Omit to skip.

  • criteria

    array — Explicit fulltext-stage criteria.

    Items:

    • instructions (required)

      string — Plain-language instructions used to judge whether a paper meets this criterion

    • name (required)

      string — Short name for the criterion

  • depth

    string, possible values: "fast", "thorough", default: "thorough" — How thoroughly Elicit judges each full text against your criteria, with the same trade-off as `abstractScreening.depth`: `thorough` applies the criteria in full, records the quotes behind each decision, and requires higher usage; `fast` returns decisions without supporting quotes and wrongly excludes more papers that met your criteria. The person you are acting for chooses this — do not decide it yourself, and ask them if they have not said which they want. Omitting this field means `thorough`.

  • reuseAbstractCriteria

    boolean, default: false — When true, the abstract-stage criteria are also applied at the fulltext stage.

• generateReport

  boolean, default: false — Generate a full report at the end of the review. Requires `extraction`.

• isPublic

  boolean, default: false — Whether the review should be publicly accessible via its URL without authentication. Defaults to false.

• protocolDetails

  string — Free-form context (PICO, methodology, inclusion/exclusion rationale) used when Elicit generates screening criteria, extraction columns, or the final report.

• searches

  array, default: [] — Searches that feed the review pipeline. If omitted or empty, Elicit runs a semantic search using `researchQuestion` as the query. Total search results are subject to plan-specific limits.

  Items:

  • query (required)

    string — Search query

  • corpus

    string, possible values: "elicit", "pubmed", "clinical_trials", default: "elicit" — Corpus to search. `elicit` (default) searches Elicit's full academic paper index, spanning most research domains. `pubmed` restricts results to PubMed. `clinical_trials` returns registered trials only.

  • maxResults

    integer, default: 200 — Maximum number of papers to retrieve from this search. Plan-specific caps apply.

  • searchMode

    string, possible values: "semantic", "keyword", default: "semantic" — `semantic` (default) uses vector-similarity retrieval; `keyword` uses literal keyword matching.

• title

  string — Optional title for the review.

Content-Type: application/json

Example:

{
  "type": "systematicReview",
  "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "url": "",
  "isPublic": true,
  "settings": {
    "abstractScreeningDepth": "fast",
    "fulltextScreeningDepth": "fast",
    "useFigures": null
  },
  "links": {
    "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
    "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "type": "systematicReview",
  "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "executionStage": "gathering_sources",
  "url": "",
  "isPublic": true,
  "error": {
    "code": "",
    "message": ""
  },
  "data": {
    "search": {
      "csv": "",
      "xlsx": ""
    },
    "screen": {
      "csv": "",
      "xlsx": ""
    },
    "fulltext": {
      "csv": "",
      "xlsx": ""
    },
    "extract": {
      "csv": "",
      "xlsx": ""
    },
    "report": {
      "result": {
        "title": "",
        "summary": "",
        "reportBody": null,
        "abstract": null
      },
      "pdf": "",
      "docx": "",
      "txt": "",
      "bib": "",
      "ris": ""
    }
  },
  "dataFreshness": null,
  "exportsStatus": "ready",
  "links": {
    "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
    "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "sessions": [
    {
      "type": "report",
      "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
      "status": "processing",
      "executionStage": "gathering_sources",
      "title": "What are the effects of GLP-1 receptor agonists on cardiovascular outcomes?",
      "url": "https://elicit.com/review/5ad08bfb-cbe0-4911-a8c3-309760d33029",
      "source": "api",
      "createdAt": "2025-06-15T14:30:00.000Z",
      "isPublic": false,
      "role": "owner",
      "links": {
        "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
        "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
      }
    }
  ],
  "nextCursor": "2025-06-15T14:30:00.000Z_5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "totalCount": 1
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "type": "report",
  "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "executionStage": "screening_abstract",
  "url": "",
  "isPublic": true,
  "links": {
    "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
    "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

• email (required)

  string, format: email — Email address to share the session with, as a read-only recipient.

Content-Type: application/json

Example:

{
  "sessionId": "",
  "share": {
    "email": "colleague@example.com",
    "status": "registered",
    "role": "reader"
  },
  "url": ""
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "sessionId": "",
  "shares": [
    {
      "email": "colleague@example.com",
      "status": "registered",
      "role": "reader"
    }
  ],
  "url": ""
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

• email (required)

  string, format: email — Email address whose direct share or pending invite should be revoked, at any role. This can remove editor/reviewer permissions even when the email is absent from the read-only share list.

Content-Type: application/json

Example:

{
  "sessionId": "",
  "email": "",
  "revoked": true
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "hasUsageRemaining": true,
  "percentUsed": 1,
  "periodStart": "",
  "periodEnd": "",
  "extraUsage": {
    "limitUsdCents": null,
    "spentUsdCents": 1
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

• query (required)

  string — The initial query for the research agent. Elicit creates a stateful research session that investigates the query. The session is continuable in the Elicit web interface.

• attachments

  array — Files to attach to this turn, each referencing a file_id from POST /api/v2/files. A session can hold at most 20 distinct files across all turns. An already-attached file can be referenced again in the same session, but not claimed by another session or import. Duplicate file_ids within one request are rejected.

  Items:

  • file_id (required)

    string, format: uuid — The file_id returned by POST /api/v2/files for a previously uploaded file.

Content-Type: application/json

Example:

{
  "sessionId": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "status": "processing",
  "url": "https://elicit.com/agent/a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "type": "agent",
  "sessionId": "5ad08bfb-cbe0-4911-a8c3-309760d33029",
  "status": "processing",
  "title": "",
  "url": "",
  "source": "api",
  "createdAt": "2025-06-15T14:30:00.000Z",
  "isPublic": true,
  "links": {
    "self": "https://elicit.com/api/v2/sessions/reports/5ad08bfb-cbe0-4911-a8c3-309760d33029",
    "resume": "https://elicit.com/api/v2/sessions/5ad08bfb-cbe0-4911-a8c3-309760d33029/resume"
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json

Example:

{
  "error": "Rate limit exceeded",
  "message": "Too many requests. Please try again later."
}

Content-Type: application/json

Example:

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid search request",
    "sessionId": ""
  }
}

Content-Type: application/json