---
title: "search serial meta data by zbMATH style user query"
method: GET
path: "/serial/_search"
tags: ["v1 serial"]
---

# search serial meta data by zbMATH style user query

`GET /serial/_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 

 
 - **Ann* Math***: Search for the expressions in <strong>all fields</strong>.  Abbreviations are also possible.
- **jt:''Annals of Mathematics''**: Search for the exact <strong><u>j</u>ournal <u>t</u>itle</strong> phrase.
- **jt:annals pu:mathematics**: Search for <strong> <u>j</u>ournal <u>t</u>itle</strong> containing the sequence <em>annals</em> and <strong><u>pu</u>blisher</strong> containing the sequence <em>mathematics</em>.
- **sn:0003-486X**: Search for <strong>IS<u>SN</u></strong>. Both electronic and print ISSN are accepted.
- **se:2531**: Search for the exact <strong><u>se</u>rial identifier</strong>. This excludes homonyms. Compare to <a href='https://zbmath.org/serials/?q=jt%3AAnnals+of+Mathematics'>jt:Annals of Mathematics</a>.
- **jt:Annals cc:05**: Search for <strong><u>j</u>ournal <u>t</u>itle</strong> containing the sequence <em>Annals</em> and <strong><u>c</u>lassification <u>c</u>ode</strong> of its main field (first two digits of MSC code).
- **jt:Annals (cy:CN|RO)**: Search for <strong><u>j</u>ournal <u>t</u>itle</strong> and <strong><u>c</u>ountr<u>y</u></strong> published in (here either China or Romania in two-digit <a href='https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes'>ISO 3166-1</a> standard codes).
- **tp:b**: Search for serials of <strong><u>t</u>y<u>p</u>e</strong> <em><u>b</u>ook series</em>.
- **tp:j st:o t**: Search for serials of <strong><u>t</u>y<u>p</u>e</strong> <em><u>j</u>ournal</em> which are in the <strong><u>st</u>ate</strong> <em><u>o</u>pen access</em> and currently indexed <em>cover-<u>t</u>o-cover</em>.
- **tp:c r**: Search for serials that are <em><u>c</u>ited</em> and have <em><u>r</u>eferences</em>.
- **py:1800-1899 la:no**: Search for <em>19th century</em> serials which published in <em><u>No</u>rwegian</em>.

# Search fields

 
 - **any**: Includes cc, cy, jt, la, li, pu, sn
- **cy**: Country of the publisher (use name, e.g., <em>cy:France</em>, or <a href='https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes'>ISO 3166-1</a> codes, e.g., <em>cy:FR</em>)
- **sn**: International Standard Serial Number (ISSN)
- **la**: Languages of indexed documents (<em>la:French</em>, or <a href='https://en.wikipedia.org/wiki/ISO_639-1'>ISO 639-1</a> codes, e.g., <em>la:FR</em>)
- **cc**: Main fields of the serial (given by first two MSC digits)
- **pu**: Name/location of the publisher or editorial institution
- **se**: zbMATH serial ID
- **tp**: Type: journal (<em>tp:j</em>), book series (<em>tp:b</em>)
- **st**: State: open access (<em>st:o</em>), currently indexed (<em>st:v</em>), indexed cover to cover (<em>st:t</em>), is cited (<em>st:c</em>), has references (<em>st:r</em>)
- **jt**: Title, acronym or short title
- **li**: External link (URL)
- **py**: Time period the serial has been active (interval search with &ldquo;-&rdquo;)

 # 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

- ZbmathdatamodelsDisplaySerialResultSearch
  - `result` Serial[]
    - `acronym` string
    - `comments` unknown[]
      - unknown
    - `countries` WhichCountry[]
      - `code` string
      - `country` 'International Institute for Applied Systems Analysis (IIASA)' | 'Eritrea' | 'Mayotte' | 'South Georgia and the South Sandwich Islands' | 'France, Metropolitan' | 'Andorra' | 'Not defined' | 'United Arab Emirates' | 'Afghanistan' | 'Antigua and Barbados' | 'Albania' | 'Angola' | 'Argentina' | 'Austria' | 'Australia' | 'Barbados' | 'Bangladesh' | 'Belgium' | 'Burkina Faso' | 'Bulgaria' | 'Bahrain' | 'Burundi' | 'Benin' | 'Bermuda' | 'Brunei Darussalam' | 'Bolivia' | 'Brazil' | 'Bahamas' | 'Bhutan' | 'Burma' | 'Botswana' | 'Belarus' | 'Belize' | 'Canada' | 'Central African Republic' | 'Congo' | 'Switzerland' | 'Cote d'Ivoire' | 'Chile' | 'Cameroon' | 'China' | 'Colombia' | 'Costa Rica' | 'Cuba' | 'Cape Verde' | 'Cyprus' | 'German Democratic Republic' | 'Germany' | 'Djibouti' | 'Denmark' | 'Dominica' | 'Dominican Republic' | 'Algeria' | 'Ecuador' | 'Egypt' | 'Spain' | 'Ethiopia' | 'Finland' | 'Fiji' | 'France' | 'Gabon' | 'United Kingdom' | 'Grenada' | 'Ghana' | 'Gambia' | 'Guinea' | 'Equatorial Guinea' | 'Greece' | 'Guatemala' | 'Guinea-Bissau' | 'Guyana' | 'Hong Kong' | 'Honduras' | 'Haiti' | 'Hungary' | 'Indonesia' | 'Ireland' | 'Israel' | 'India' | 'Iraq' | 'Iran (Islamic Republic of)' | 'Iceland' | 'Italy' | 'Jamaica' | 'Jordan' | 'Japan' | 'Kenya' | 'Cambodia' | 'Kiribati' | 'Comoros' | 'Korea, Democratic People's Republic of' | 'Korea, Republic of' | 'Kuwait' | 'Lao People's Democratic Republic' | 'Lebanon' | 'Sainte-Lucie' | 'Liechtenstein' | 'Sri Lanka' | 'Liberia' | 'Lesotho' | 'Luxembourg' | 'Libyan Arab Jamahiriya' | 'Morocco' | 'Monaco' | 'Madagascar' | 'Mali' | 'Mongolia' | 'Mauritania' | 'Malta' | 'Mauritius' | 'Maldives' | 'Malawi' | 'Mexico' | 'Malaysia' | 'Mozambique' | 'Niger' | 'Nigeria' | 'Nicaragua' | 'Netherlands' | 'Norway' | 'Nepal' | 'Nauru' | 'New Zealand' | 'Oman' | 'Panama' | 'Peru' | 'Papua New Guinea' | 'Philippines' | 'Pakistan' | 'Poland' | 'Puerto Rico' | 'Portugal' | 'Paraguay' | 'Qatar' | 'Romania' | 'Rwanda' | 'Saudi Arabia' | 'Solomon Islands' | 'Seychelles' | 'Sudan' | 'Sweden' | 'Singapore' | 'Sierra Leone' | 'San Marino' | 'Senegal' | 'Somalia' | 'Suriname' | 'Sao Tome and Principe' | 'USSR' | 'El Salvador' | 'Syrian Arab Republic' | 'Swaziland' | 'Chad' | 'Togo' | 'Thailand' | 'Tunisia' | 'Tonga' | 'Turkey' | 'Trinidad and Tobago' | 'Tuvalu' | 'Tanzania, United Republic of' | 'Ukraine' | 'Uganda' | 'United States of America' | 'Uruguay' | 'Vatican City State' | 'Saint Vincent and the Grenadines' | 'Venezuela' | 'Viet Nam' | 'Vanuatu' | 'Samoa' | 'Yemen, Democratic' | 'Yemen' | 'Yugoslavia' | 'South Africa' | 'Zambia' | 'Zaire' | 'Zimbabwe' | 'Serbia and Montenegro' | 'Anguilla' | 'Netherlands Antilles' | 'Antarctica' | 'American Samoa' | 'Aruba' | 'Bouvet Island' | 'Cocos (Keeling) Islands' | 'Myanmar' | 'Cook Islands' | 'Christmas Island' | 'Western Sahara' | 'Falkland Islands (Malvinas)' | 'Micronesia (Federated States of)' | 'Faroe Islands' | 'French Guiana' | 'Gibraltar' | 'Greenland' | 'Guadeloupe' | 'Guam' | 'Heard Island and McDonald Islands' | 'British Indian Ocean Territory' | 'Saint Kitts and Nevis' | 'Cayman Islands' | 'Marshall Islands' | 'Montserrat' | 'Namibia' | 'Norfolk Island' | 'Macau' | 'Northern Mariana Islands' | 'Martinique' | 'Niue' | 'French Polynesia' | 'Saint Pierre and Miquelon' | 'Pitcairn' | 'Palau' | 'Reunion' | 'Saint Helena' | 'Svalbard and Jan Mayen Islands' | 'Turks and Caicos Islands' | 'French Southern Territories' | 'Tokelau' | 'East Timor' | 'Taiwan, Province of China' | 'United States Minor Outlying Islands' | 'Wallis and Futuna Islands' | 'Virgin Islands (British)' | 'Virgin Islands (U.S.)' | 'Lithuania' | 'New Caledonia' | 'International Atomic Energy Agency (IAEA)' | 'European Organization for Nuclear Research (CERN)' | 'OECD, Paris' | 'Commission of the European Communities (CEC)' | 'Food and Agriculture Organization of the UN (FAO)' | 'Joint Institute for Nuclear Research (JINR)' | 'Council for Mutual Economic Assistance (CMEA)' | 'Nuclear Energy Agency of the OECD (NEA)' | 'International Commission on Radiological Protection (ICRP)' | 'International Organization for Standardization (ISO)' | 'United Nations (UN)' | 'World Health Organization (WHO)' | 'World Energy Conference (WEC)' | 'International Energy Agency (IEA)' | 'Armenia' | 'Azerbaijan' | 'Estonia' | 'Georgia' | 'Croatia' | 'Kyrgyzstan' | 'Kazakhstan' | 'Latvia' | 'Moldova, Republic of' | 'Neutral Zone' | 'Russian Federation' | 'Tajikistan' | 'Turkmenistan' | 'Uzbekistan' | 'Slovenia' | 'Arab Atomic Energy Agency' | 'International Organisations without Location' | 'Comprehensive Nuclear Test-ban Treaty Organization (CTBTO)' | 'United Nations Industrial Development Organization (UNIDO)' | 'Czech Republic' | 'Slovakia' | 'Bosnia and Herzegovina' | 'Euro' | 'Macedonia, the former Yugoslav Republic of' | 'Congo, the Democratic Republic of' | 'Occupied Palestinian Territory' | 'Kosovo' | 'Serbia' | 'Montenegro' — An enumeration.
    - `id` integer
    - `issn` ZbmathdatamodelsDisplaySerialSubmodelsISSN[]
      - `number` string
      - `type` 'electronic' | 'print' — An enumeration.
    - `languages` Languages
      - `documents` WhichLanguage[]
        - `code` string
        - `language` 'Afrikaans' | 'Arabic' | 'Bulgarian' | 'Byelorussian' | 'Chinese' | 'Czech' | 'Danish' | 'Dutch' | 'English' | 'Finnish' | 'French' | 'German' | 'Hindi' | 'Hungarian' | 'Indonesian' | 'Italian' | 'Japanese' | 'Korean' | 'Lithuanian' | 'Malay' | 'Norwegian' | 'Persian' | 'Polish' | 'Portuguese' | 'Romanian' | 'Russian' | 'Serbo-Croat' | 'Slovak' | 'Spanish' | 'Swedish' | 'Thai' | 'Turkish' | 'Ukrainian' | 'Welsh' | 'Punjabi' | 'Urdu' | 'Polyglott?' | 'Not defined' | 'Tamil' | 'Greek' | 'Hebrew' | 'Slovenian' | 'Latin' | 'Georgian' | 'Serbian' | 'Moldavian' | 'Latvian' | 'Estonian' | 'Catalan' | 'Azerbaijani' | 'Esperanto' | 'Croatian' | 'Macedonian' | 'Vietnamese' | 'Frisian' | 'Sanskrit' | 'Basque' | 'Icelandic' | 'Aymara' | 'Bashkir' | 'Bihari' | 'Bislama' | 'Bengali' | 'Tibetan' | 'Corsican' | 'Javanese' | 'Samoan' | 'Faroese' | 'Mongolian' | 'Irish' | 'Scots Gaelic' | 'Galician' | 'Breton' | 'Afar' | 'Abkhazian' | 'Amharic' | 'Assamese' | 'Armenian' | 'Turkmen' | 'Kazakh' | 'Uzbek' | 'Interlingua' | 'Albanian' | 'language not recognized' — An enumeration.
      - `abstracts` WhichLanguage[]
        - `code` string
        - `language` 'Afrikaans' | 'Arabic' | 'Bulgarian' | 'Byelorussian' | 'Chinese' | 'Czech' | 'Danish' | 'Dutch' | 'English' | 'Finnish' | 'French' | 'German' | 'Hindi' | 'Hungarian' | 'Indonesian' | 'Italian' | 'Japanese' | 'Korean' | 'Lithuanian' | 'Malay' | 'Norwegian' | 'Persian' | 'Polish' | 'Portuguese' | 'Romanian' | 'Russian' | 'Serbo-Croat' | 'Slovak' | 'Spanish' | 'Swedish' | 'Thai' | 'Turkish' | 'Ukrainian' | 'Welsh' | 'Punjabi' | 'Urdu' | 'Polyglott?' | 'Not defined' | 'Tamil' | 'Greek' | 'Hebrew' | 'Slovenian' | 'Latin' | 'Georgian' | 'Serbian' | 'Moldavian' | 'Latvian' | 'Estonian' | 'Catalan' | 'Azerbaijani' | 'Esperanto' | 'Croatian' | 'Macedonian' | 'Vietnamese' | 'Frisian' | 'Sanskrit' | 'Basque' | 'Icelandic' | 'Aymara' | 'Bashkir' | 'Bihari' | 'Bislama' | 'Bengali' | 'Tibetan' | 'Corsican' | 'Javanese' | 'Samoan' | 'Faroese' | 'Mongolian' | 'Irish' | 'Scots Gaelic' | 'Galician' | 'Breton' | 'Afar' | 'Abkhazian' | 'Amharic' | 'Assamese' | 'Armenian' | 'Turkmen' | 'Kazakh' | 'Uzbek' | 'Interlingua' | 'Albanian' | 'language not recognized' — An enumeration.
    - `lineage` Lineage
      - `predecessors` unknown[]
        - unknown
      - `successors` unknown[]
        - unknown
    - `main_fields` ZbmathdatamodelsDisplaySerialSubmodelsMainField[]
      - `count` integer
      - `field` string
      - `percent` number
      - `percentile` number
    - `online_availability` string
    - `parallel_title` string
    - `publisher` string
    - `serial_type` 'book_series' | 'journal_series' — An enumeration.
    - `short_title` string
    - `states` State[]
    - `sub_series` unknown[]
      - unknown
    - `sub_title` string
    - `title` string
    - `translation` Translation
      - `translated_from` unknown[]
        - unknown
      - `translated_to` unknown[]
        - unknown
    - `urls` unknown[]
      - unknown
    - `zbmath_start` string
    - `zbmath_stop` string
    - `zbmath_years` unknown[]
      - unknown
    - `zbmath_url` string
    - `metadata` MetaData
      - `type` 'author' | 'classification' | 'document' | 'serial' | 'software' | 'undefined' — An enumeration.
      - `score` number
      - `data_source` 'ELASTIC' | 'DATABASE' | 'undefined' — An enumeration.
      - `censored_fields` 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)
