---
title: "Get ElasticityDoc documents"
method: GET
path: "/materials/elasticity/"
tags: ["Materials Elasticity"]
---

# Get ElasticityDoc documents

`GET /materials/elasticity/`

## Query parameters

- `material_ids` string, nullable — Comma-separated list of material_id values to query on
- `chemsys` string, nullable — A comma delimited string list of chemical systems.
- `k_voigt_max` number, nullable — Maximum value for the Voigt average of the bulk modulus in GPa.
- `k_voigt_min` number, nullable — Minimum value for the Voigt average of the bulk modulus in GPa.
- `k_reuss_max` number, nullable — Maximum value for the Reuss average of the bulk modulus in GPa.
- `k_reuss_min` number, nullable — Minimum value for the Reuss average of the bulk modulus in GPa.
- `k_vrh_max` number, nullable — Maximum value for the Voigt-Reuss-Hill average of the bulk modulus in GPa.
- `k_vrh_min` number, nullable — Minimum value for the Voigt-Reuss-Hill average of the bulk modulus in GPa.
- `g_voigt_max` number, nullable — Maximum value for the Voigt average of the shear modulus in GPa.
- `g_voigt_min` number, nullable — Minimum value for the Voigt average of the shear modulus in GPa.
- `g_reuss_max` number, nullable — Maximum value for the Reuss average of the shear modulus in GPa.
- `g_reuss_min` number, nullable — Minimum value for the Reuss average of the shear modulus in GPa.
- `g_vrh_max` number, nullable — Maximum value for the Voigt-Reuss-Hill average of the shear modulus in GPa.
- `g_vrh_min` number, nullable — Minimum value for the Voigt-Reuss-Hill average of the shear modulus in GPa.
- `elastic_anisotropy_max` number, nullable — Maximum value for the elastic anisotropy.
- `elastic_anisotropy_min` number, nullable — Maximum value for the elastic anisotropy.
- `poisson_max` number, nullable — Maximum value for Poisson's ratio.
- `poisson_min` number, nullable — Minimum value for Poisson's ratio.
- `_page` integer — Page number to request (takes precedent over _limit and _skip).
- `_per_page` integer — Number of entries to show per page (takes precedent over _limit and _skip). Limited to 1000.
- `_skip` integer — Number of entries to skip in the search.
- `_limit` integer — Max number of entries to return in a single query. Limited to 1000.
- `_fields` string — Fields to project from ElasticityDoc as a list of comma separated strings. Fields include: `builder_meta` `nsites` `elements` `nelements` `composition` `composition_reduced` `formula_pretty` `formula_anonymous` `chemsys` `volume` `density` `density_atomic` `symmetry` `material_id` `deprecated` `deprecation_reasons` `last_updated` `origins` `warnings` `structure` `property_name` `order` `elastic_tensor` `compliance_tensor` `bulk_modulus` `shear_modulus` `sound_velocity` `thermal_conductivity` `young_modulus` `universal_anisotropy` `homogeneous_poisson` `debye_temperature` `fitting_data` `fitting_method` `state`
- `_all_fields` boolean — Include all fields.
- `id_format` string, nullable — Optional. If set to 'legacy', MP identifier fields in the response are returned in the form 'mp-149'. If set to 'alpha', they are returned in the padded AlphaID form 'mp-aaaaaaft'. If omitted (or set to any other value), identifiers are returned in their stored form. This is a purely cosmetic transform; query inputs accept either shape regardless.

## Response `200`

Search for a ElasticityDoc

- ResponseElasticityDoc
  - `data` ElasticityDoc[], nullable — List of returned data — unresolved $ref
  - `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

- **2026-08-20** `70f72d0670df` — 4 info
  - added the new optional `query` request parameter `id_format`
  - the `api_version` response's property default value changed from `0.87.2.dev19+g3f2daf4f8` to `0.87.3.dev3+gfbe8656b6` for the status `200`
  - the `emmet_version` response's property default value changed from `0.87.1` to `0.87.2` for the status `200`
  - the `pymatgen_version` response's property default value changed from `2026.5.18` to `2026.8.13` for the status `200`
- **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/elasticity/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)