---
title: "search documents by descriptive field names"
method: GET
path: "/document/_structured_search"
tags: ["v1 document"]
---

# search documents by descriptive field names

`GET /document/_structured_search`

# Description

 
 
 For searching in zbMATH you may employ the Structured Search for convenient combination of all search fields. While similar to the 1-line syntax search, this endpoint offers much more convenience and transparency which fields are searched at the cost of search flexibility.
 # Examples 

 
 - **contributor_name: 'smith'**: Search for author, author reference or editor named **Smith**
- **year: '2002-2005'**: Search for documents published in the years from **2002** until **2005**
- **reference_author_code: 'ghezelahmad.somayeh-khalashi'**: Search for documents with references that were written by the author with the zbMATH code **smith.ivan**
- **reference_zbmath_id: '6383667'**: Search for documents that reference to a document with the zbMATH id **6383667**
- **zbmath_id: '6383667'**: Search for the document with the zbMATH id **6383667**. zbMATH id includes all types of identifiers used on zbmath.org, i.e.: pre ID, Zbl ID, JFM ID, ERAM ID

# Search fields

 
 - **Anywhere**: Includes ab, au, cc, en, rv, so, ti, ut
- **arXiv ID**: arXiv preprint number
- **Author count**: Number of authors (interval search with “-”)
- **Author name**: Name of author, editor, or other contributor
- **Biographic reference**: Name of a person with biographic references (to find documents about the life or work)
- **Database**: 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>)
- **Document cited in summary/review**: zbMATH Open ID of a document cited in summary or review
- **Document type**: 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)
- **Editor name**: Name of the editor of a book or special issue
- **External ID**: External document ID: DOI, arXiv ID, ISBN, and others
- **Keyword**: Keywords
- **Language**: 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>
- **MSC**: Code from the Mathematics Subject Classification (prefix with <strong>*</strong> to restrict to primary MSC)
- **Publisher**: Name of publisher
- **Reference text**: Publications containing the given text in its list of references
- **Review text**: Text from the summary or review
- **Reviewer ID**: ID of the reviewer
- **Reviewer name**: Name or ID of the reviewer
- **Reviewing state**: 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>)
- **Serial ID**: ID of the serial
- **Software ID**: swMATH ID of software referred to in a document
- **Software name**: Name of software referred to in a document
- **Source**: Bibliographical source (serial title, volume/issue number, page range, year of publication, ISBN, etc.)
- **State**: State: is cited (<em>st:c</em>), has references (<em>st:r</em>), has open version (<em>st:o</em>)
- **Title**: Title of the document
- **URL**: External link (URL)
- **Year**: Year of publication (interval search with &ldquo;-&rdquo;)
- **zbMATH Open document ID**: zbMATH Open document ID (preliminary ID, Zbl number, JFM number, or ERAM number)

## Query parameters

- `page` integer — pagination for result page
- `results_per_page` integer
- `Anywhere` string — Includes ab, au, cc, en, rv, so, ti, ut
- `arXiv ID` string — arXiv preprint number
- `Author count` string — Number of authors (interval search with &ldquo;-&rdquo;)
- `Author name` string — Name of author, editor, or other contributor
- `Biographic reference` string — Name of a person with biographic references (to find documents about the life or work)
- `Database` string — 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>)
- `Document cited in summary/review` string — zbMATH Open ID of a document cited in summary or review
- `Document type` string — 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` string — Digital Object Identifier (DOI)
- `Editor name` string — Name of the editor of a book or special issue
- `External ID` string — External document ID: DOI, arXiv ID, ISBN, and others
- `Keyword` string — Keywords
- `Language` string — 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>
- `MSC` string — Code from the Mathematics Subject Classification (prefix with <strong>*</strong> to restrict to primary MSC)
- `Publisher` string — Name of publisher
- `Reference text` string — Publications containing the given text in its list of references
- `Review text` string — Text from the summary or review
- `Reviewer ID` string — ID of the reviewer
- `Reviewer name` string — Name or ID of the reviewer
- `Reviewing state` string — 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>)
- `Serial ID` string — ID of the serial
- `Software ID` string — swMATH ID of software referred to in a document
- `Software name` string — Name of software referred to in a document
- `Source` string — Bibliographical source (serial title, volume/issue number, page range, year of publication, ISBN, etc.)
- `State` string — State: is cited (<em>st:c</em>), has references (<em>st:r</em>), has open version (<em>st:o</em>)
- `Title` string — Title of the document
- `URL` string — External link (URL)
- `Year` string — Year of publication (interval search with &ldquo;-&rdquo;)
- `zbMATH Open document ID` string — zbMATH Open document ID (preliminary ID, Zbl number, JFM number, or ERAM number)

## 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)