--- title: "Get SynthesisSearchResultModel documents" method: GET path: "/materials/synthesis/" tags: ["Materials Synthesis"] --- # Get SynthesisSearchResultModel documents `GET /materials/synthesis/` ## Query parameters - `keywords` string, nullable — Comma delimited string keywords to search synthesis paragraph text with. - `synthesis_type` string[], nullable — Type of synthesis to include. - `target_formula` string, nullable — Chemical formula of the target material. - `precursor_formula` string, nullable — Chemical formula of the precursor material. - `operations` string[], nullable — List of operations that syntheses must have. - `condition_heating_temperature_min` number, nullable — Minimal heating temperature. - `condition_heating_temperature_max` number, nullable — Maximal heating temperature. - `condition_heating_time_min` number, nullable — Minimal heating time. - `condition_heating_time_max` number, nullable — Maximal heating time. - `condition_heating_atmosphere` string[], nullable — Required heating atmosphere, such as "air", "argon". - `condition_mixing_device` string[], nullable — Required mixing device, such as "zirconia", "Al2O3". - `condition_mixing_media` string[], nullable — Required mixing media, such as "alcohol", "water". - `_skip` integer — Number of entries to skip in the search - `_limit` integer — Max number of entries to return in a single query. Limited to 10. ## Response `200` Get SynthesisSearchResultModel data - ResponseSynthesisSearchResultModel - `data` SynthesisSearchResultModel[], nullable — List of returned data - `doi` string, nullable — DOI of the journal article. - `paragraph_string` string, nullable — The paragraph from which this recipe is extracted. - `synthesis_type` string, nullable — Type of the synthesis recipe. - `reaction_string` string, nullable — String representation of this recipe. - `reaction` ReactionFormula — Model for a balanced reaction - `left_side` FormulaPart[], required — List of materials and their amounts at the left side. - `amount` string — Amount of the compound in a formula. - `material` string, required — The compound that participates in a reaction. - `right_side` FormulaPart[], required — List of materials and their amounts at the right side. - `amount` string — Amount of the compound in a formula. - `material` string, required — The compound that participates in a reaction. - `element_substitution` object — Dictionary that contains elemental substitutions - `target` ExtractedMaterial — Model for a material extracted from the literature - `material_string` string, required — String of the material as written in paper. - `material_formula` string, required — Normalized formula of the material. - `material_name` string, nullable — English name of the material. - `phase` string, nullable — Phase description of material, such as anatase. - `is_acronym` boolean, nullable — Whether the material is an acronym, such as LMO for LiMn2O4. - `composition` Component[], required — List of components in this material. - `formula` string, required — Formula of this component. - `amount` string, required — Amount of this component. - `elements` object, required — Amount of each chemical elements in this component. - `amounts_vars` object — Amount variables (formula subscripts). - `elements_vars` object — Chemical element variables - `additives` string[] — list of additives, dopants, etc. - `oxygen_deficiency` string, nullable — Symbol indicating whether the materials is oxygen deficient. - `targets_formula` string[], nullable — List of synthesized target material compositions. - `precursors_formula` string[], nullable — List of precursor material compositions. - `targets_formula_s` string[], nullable — List of synthesized target material compositions, as strings. - `precursors_formula_s` string[], nullable — List of precursor material compositions, as strings. - `precursors` ExtractedMaterial[], nullable — List of precursor materials. - `material_string` string, required — String of the material as written in paper. - `material_formula` string, required — Normalized formula of the material. - `material_name` string, nullable — English name of the material. - `phase` string, nullable — Phase description of material, such as anatase. - `is_acronym` boolean, nullable — Whether the material is an acronym, such as LMO for LiMn2O4. - `composition` Component[], required — List of components in this material. - `formula` string, required — Formula of this component. - `amount` string, required — Amount of this component. - `elements` object, required — Amount of each chemical elements in this component. - `amounts_vars` object — Amount variables (formula subscripts). - `elements_vars` object — Chemical element variables - `additives` string[] — list of additives, dopants, etc. - `oxygen_deficiency` string, nullable — Symbol indicating whether the materials is oxygen deficient. - `operations` Operation[], nullable — List of operations used to synthesize this recipe. - `type` string, required — Type of the operation as classified by the pipeline. - `token` string, required — Token (word) of the operation as written in paper. - `conditions` Conditions, required - `heating_temperature` Value[], nullable — Heating temperatures. - `min_value` number, nullable — Minimal value. - `max_value` number, nullable — Maximal value. - `values` number[] — Enumerated values in the literature. - `units` string, required — Unit of this value. - `heating_time` Value[], nullable — Heating times. - `min_value` number, nullable — Minimal value. - `max_value` number, nullable — Maximal value. - `values` number[] — Enumerated values in the literature. - `units` string, required — Unit of this value. - `heating_atmosphere` string[], nullable — List of heating atmospheres. - `mixing_device` string, nullable — Mixing device, if this operation is MIXING. - `mixing_media` string, nullable — Mixing media, if this operation is MIXING. - `search_score` number, nullable — Search score. - `highlights` AtlasSearchHighlight[], nullable — Search highlights. - `score` number, nullable - `path` string, nullable - `texts` AtlasSearchText[], nullable - `value` string, nullable - `type` string, nullable - `errors` Error[], nullable — Any errors on processing this query - `code` integer, required — The error code - `message` string, required — The description of the error - `meta` Meta — Meta information for the MAPI Response. - `api_version` string — A string containing the version of the Materials API implementation, e.g. v0.9.5 - `time_stamp` string, date-time — A string containing the date and time at which the query was executed - `total_doc` integer, nullable — The total number of documents available for this query - `facet` object, nullable — A dictionary containing the facets available for this query ## Other responses - `422` — Validation Error ## Changes > 4 revisions in range; 1 could not be searched. - **2026-07-31** `54f2f79ab4f8` — 1 info - the `api_version` response's property default value changed from `0.87.2.dev13+g62063a867` to `0.87.2.dev19+g3f2daf4f8` for the status `200` - **2026-07-26** `9aac4fdf4081` — 1 info - the `api_version` response's property default value changed from `0.87.2.dev4+g6bd8ed856` to `0.87.2.dev13+g62063a867` for the status `200` [Change history](https://skmtc.dev/materialsproject/apis/materials-project-api/changes/materials/synthesis/get.md) --- [API](https://skmtc.dev/materialsproject/apis/materials-project-api.md) · [All operations](https://skmtc.dev/materialsproject/apis/materials-project-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/materialsproject/materials-project-api/revisions/70f72d0670df/schema)