---
title: "search documents by zbMATH style user query"
method: GET
path: "/document/_search"
tags: ["v1 document"]
---

# search documents by zbMATH style user query

`GET /document/_search`

# Description

 
 The syntax search allows for free logical combinations of all available search fields. While similar to the structured search, this endpoint offers much more flexibility at the cost of obscure search parameters.
 # Examples 

 
 - **Geometry**: Search for the term <em>Geometry</em> in <strong>any</strong> field. Queries are <strong>case-independent</strong>.
- **Funct***: <strong>Wildcard</strong> queries are specified by <u>*</u> (e.g. <em>functions</em>, <em>functorial</em>, etc.). Otherwise the search is <strong>exact</strong>.
- **"Topological group"**: <strong>Phrases</strong> (multi-words) should be set in <u>"</u>straight quotation marks<u>"</u>.
- **au:Bourbaki & ti:Algebra**: Search for <strong><u>au</u>thor</strong> <em>Bourbaki</em> and <strong><u>ti</u>tle</strong> <em>Algebra</em>. The <strong>and-operator &</strong> is default and can be omitted.
- **Chebyshev | Tschebyscheff**: The <strong>or</strong>-operator <strong>|</strong> allows to search for <em>Chebyshev</em> or <em>Tschebyscheff</em>.
- **Quasi* map* py:1989**: The resulting documents have <strong><u>p</u>ublication <u>y</u>ear</strong> <em>1989</em>.
- **so:Eur* J* Mat* Soc* cc:14**: Search for publications in a particular <strong><u>so</u>urce</strong> with a <strong>Mathematics Subject <u>C</u>lassification <u>c</u>ode</strong> in <em>14</em>.
- **cc:*35 ! any:elliptic**: Search for documents about PDEs (prefix with * to search only primary MSC); the not-operator ! eliminates all results containing the word <em>elliptic</em>.
- **dt:b & au:Hilbert**: The <strong><u>d</u>ocument <u>t</u>ype</strong> is set to <u>b</u>ooks; alternatively: <u>j</u> for <strong><u>j</u>ournal articles</strong>, <u>a</u> for <strong>book <u>a</u>rticles</strong>.
- **py:2000-2015 cc:(94A | 11T)**: Number <strong>ranges</strong> when searching for <strong><u>p</u>ublication <u>y</u>ear</strong> are accepted. Terms can be grouped within <strong><u>( </u>parentheses<u> )</u></strong>.
- **la:chinese**: Find documents in a given <strong><u>la</u>nguage</strong>. <a href='https://en.wikipedia.org/wiki/ISO_639-1'>ISO 639-1</a> (opens in new tab) language codes can also be used.
- **st:c r o**: Find documents that are <strong><u>c</u>ited</strong>, have <strong><u>r</u>eferences</strong> and have an <strong><u>o</u>pen version</strong>.

# Search fields

 
 - **any**: Includes ab, au, cc, en, rv, so, ti, ut
- **arxiv**: arXiv preprint number
- **na**: Number of authors (interval search with &ldquo;-&rdquo;)
- **au**: Name of author, editor, or other contributor
- **br**: Name of a person with biographic references (to find documents about the life or work)
- **db**: Database: documents in Zentralblatt für Mathematik/zbMATH Open (<em>db:Zbl</em>), Jahrbuch über die Fortschritte der Mathematik (<em>db:JFM</em>), Crelle's Journal (<em>db:eram</em>), arXiv (<em>db:arxiv</em>)
- **ci**: zbMATH Open ID of a document cited in summary or review
- **dt**: Type of the document: journal article (<em>dt:j</em>), collection article (<em>dt:a</em>), book (<em>dt:b</em>), preprint (<em>dt:p</em>)
- **doi**: Digital Object Identifier (DOI)
- **ed**: Name of the editor of a book or special issue
- **en**: External document ID: DOI, arXiv ID, ISBN, and others
- **ut**: Keywords
- **la**: Language (use name, e.g., <em>la:French</em>, or <a href='https://en.wikipedia.org/wiki/ISO_639-1'>ISO 639-1</a>, e.g., <em>la:FR)</em>
- **cc**: Code from the Mathematics Subject Classification (prefix with <strong>*</strong> to restrict to primary MSC)
- **pu**: Name of publisher
- **rft**: Publications containing the given text in its list of references
- **ab**: Text from the summary or review
- **rn**: ID of the reviewer
- **rv**: Name or ID of the reviewer
- **pt**: Reviewing state: Reviewed (<em>pt:r</em>), Title Only (<em>pt:t</em>), Pending (<em>pt:p</em>), Scanned Review (<em>pt:s</em>), Not Reviewd (<em>pt:n</em>)
- **se**: ID of the serial
- **si**: swMATH ID of software referred to in a document
- **sw**: Name of software referred to in a document
- **so**: Bibliographical source (serial title, volume/issue number, page range, year of publication, ISBN, etc.)
- **st**: State: is cited (<em>st:c</em>), has references (<em>st:r</em>), has open version (<em>st:o</em>)
- **ti**: Title of the document
- **li**: External link (URL)
- **py**: Year of publication (interval search with &ldquo;-&rdquo;)
- **an**: zbMATH Open document ID (preliminary ID, Zbl number, JFM number, or ERAM number)

 # Operators 

 
 - **a & b**: Logical and (default)
- **a | b**: Logical or
- **!ab**: Logical not
- **abc***: Right wildcard
- **ab c**: Phrase
- **(ab c)**: Term grouping

## Query parameters

- `search_string` string, required
- `page` integer
- `results_per_page` integer

## Response `200`

Successful Response

- ZbmathdatamodelsDisplayDocumentResultSearch
  - `result` Document[]
    - `biographic_references` BiographicReference[]
      - `aliases` unknown[]
        - unknown
      - `checked` string
      - `codes` unknown[]
        - unknown
      - `name` string
    - `contributors` Contributor
      - `authors` ZbmathdatamodelsDisplayDocumentSubmodelsAuthor[]
        - `aliases` unknown[]
          - unknown
        - `checked` string
        - `codes` unknown[]
          - unknown
        - `name` string
      - `author_references` AuthorReference[]
        - `aliases` unknown[]
          - unknown
        - `checked` string
        - `codes` unknown[]
          - unknown
        - `name` string
      - `editors` Editor[]
        - `aliases` unknown[]
          - unknown
        - `checked` string
        - `codes` unknown[]
          - unknown
        - `name` string
    - `database` string
    - `datestamp` string
    - `document_type` DocumentType
      - `code` string
      - `description` string
    - `editorial_contributions` EditorialContribution[]
      - `language` string
      - `reviewer` Reviewer
        - `author_code` string
        - `reviewer_id` string
        - `name` string
        - `sign` string
      - `text` string
      - `contribution_type` 'abstract' | 'from_the_text' | 'editorial_remark' | 'publishers_description' | 'review' | 'summary' | 'scan' | 'editorial' | 'not available' — An enumeration.
    - `id` integer, required
    - `identifier` string
    - `keywords` unknown[]
      - unknown
    - `language` Language
      - `languages` unknown[]
        - unknown
      - `addition` unknown[]
        - unknown
    - `license` unknown[]
      - unknown
    - `links` Link[]
      - `identifier` string
      - `type` string
      - `url` string
    - `msc` MSC[]
      - `code` string
      - `scheme` string
      - `text` string
    - `references` Reference[]
      - `doi` string
      - `position` string
      - `text` string
      - `zbmath` ZBMath
        - `author_codes` unknown[]
          - unknown
        - `document_id` integer
        - `msc` unknown[]
          - unknown
        - `prefix` string
        - `series_id` integer
        - `year` string
    - `source` Source
      - `book` Book[]
        - `book_id` integer
        - `isbn` ISBN[]
          - `number` string
          - `type` string
        - `publisher` string
        - `year` string
      - `pages` string
      - `series` Series[]
        - `acronym` string
        - `issn` ZbmathdatamodelsDisplayDocumentSubmodelsISSN[]
          - `number` string
          - `type` 'electronic' | 'print' — An enumeration.
        - `issue` string
        - `issue_id` integer
        - `parallel_title` string
        - `part` string
        - `publisher` string
        - `series_id` integer
        - `short_title` string
        - `title` string
        - `volume` string
        - `year` string
      - `source` string
    - `states` State[]
    - `title` Title
      - `addition` string
      - `original` string
      - `subtitle` string
      - `title` string
    - `year` string
    - `zbmath_url` string
  - `status` Status
    - `execution` string, required
    - `execution_bool` boolean, required
    - `internal_code` string
    - `last_id` integer
    - `nr_total_results` integer
    - `nr_request_results` integer
    - `query_execution_time_in_seconds` number
    - `status_code` integer, required
    - `time_stamp` string

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/zbmath/apis/rest-api-for-zbmath-open-v1.md) · [All operations](https://skmtc.dev/zbmath/apis/rest-api-for-zbmath-open-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zbmath/rest-api-for-zbmath-open-v1/revisions/1fcb04bb318a/schema)