---
title: "Changes to Get Structures"
method: GET
path: "/structures"
---

# Changes to Get Structures

`GET /structures`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 14 of 72 revisions.

- **2026-08-06** `843c6d7e5fff`: 1 info
- **2026-07-09** `09772e0e9095`: 4 info
- **2026-07-09** `e7eeb646f300`: 3 info
- **2026-07-09** `5439cbc3d41a`: 1 info
- **2026-06-30** `10712b001809`: 2 info
- **2025-03-03** `8d2d326d9daa`: 4 info
- **2025-02-28** `cff3a4946179`: 8 info
- **2025-02-28** `c7e74ac67f13`: 1 info
- **2025-01-27** `002049c954f2`: 9 info
- **2024-09-16** `9b788cdaec23`: 10 breaking, 109 info
- **2024-05-13** `be1576bbcbb8`: 9 breaking, 9 warning
- **2023-10-23** `8745068d2592`: 127 breaking, 215 info
- **2023-02-27** `95e421fb52e9`: 2 breaking, 2 info
- **2022-12-08** `101424246724`: 3 info

## Changes

- **2026-08-06** `843c6d7e5fff`: 1 info
  - added the optional property `data/anyOf[subschema #1]/items/attributes/wyckoff_positions` to the response with the `200` status
- **2026-07-09** `09772e0e9095`: 4 info
  - added `#/components/schemas/OptimizationType` to the `data/anyOf[subschema #1]/items/attributes/optimization_type` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/SiteCoordinateSpan` to the `data/anyOf[subschema #1]/items/attributes/site_coordinate_span` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `data/anyOf[subschema #1]/items/attributes/optimization_type` response property `anyOf` list for the response status `200`
  - removed `subschema #1` from the `data/anyOf[subschema #1]/items/attributes/site_coordinate_span` response property `anyOf` list for the response status `200`
- **2026-07-09** `e7eeb646f300`: 3 info
  - added the optional property `data/anyOf[subschema #1]/items/attributes/optimization_type` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #1]/items/attributes/site_coordinate_span` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #1]/items/attributes/site_coordinate_span_description` to the response with the `200` status
- **2026-07-09** `5439cbc3d41a`: 1 info
  - added the optional property `data/anyOf[subschema #1]/items/attributes/fractional_site_positions` to the response with the `200` status
- **2026-06-30** `10712b001809`: 2 info
  - added the optional property `data/anyOf[subschema #1]/items/relationships/anyOf[subschema #1: EntryRelationships]/files` to the response with the `200` status
  - added the optional property `included/anyOf[subschema #1]/items/relationships/anyOf[subschema #1: EntryRelationships]/files` to the response with the `200` status
- **2025-03-03** `8d2d326d9daa`: 4 info
  - added the optional property `data/anyOf[subschema #1]/items/attributes/space_group_it_number` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #1]/items/attributes/space_group_symbol_hall` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #1]/items/attributes/space_group_symbol_hermann_mauguin` to the response with the `200` status
  - added the optional property `data/anyOf[subschema #1]/items/attributes/space_group_symbol_hermann_mauguin_extended` to the response with the `200` status
- **2025-02-28** `cff3a4946179`: 8 info
  - added the optional property `meta/request_delay` to the response with the `200` status
  - added the optional property `meta/request_delay` to the response with the `400` status
  - added the optional property `meta/request_delay` to the response with the `403` status
  - added the optional property `meta/request_delay` to the response with the `404` status
  - added the optional property `meta/request_delay` to the response with the `422` status
  - added the optional property `meta/request_delay` to the response with the `500` status
  - added the optional property `meta/request_delay` to the response with the `501` status
  - added the optional property `meta/request_delay` to the response with the `553` status
- **2025-02-28** `c7e74ac67f13`: 1 info
  - added the optional property `data/anyOf[subschema #1]/items/attributes/space_group_symmetry_operations_xyz` to the response with the `200` status
- **2025-01-27** `002049c954f2`: 9 info
  - removed the `structures` enum value from the `data/anyOf[subschema #1]/items/type` response property for the response status `200`
  - removed the `warning` enum value from the `meta/warnings/anyOf[subschema #1]/items/type` response property for the response status `200`
  - removed the `warning` enum value from the `meta/warnings/anyOf[subschema #1]/items/type` response property for the response status `400`
  - removed the `warning` enum value from the `meta/warnings/anyOf[subschema #1]/items/type` response property for the response status `403`
  - removed the `warning` enum value from the `meta/warnings/anyOf[subschema #1]/items/type` response property for the response status `404`
  - removed the `warning` enum value from the `meta/warnings/anyOf[subschema #1]/items/type` response property for the response status `422`
  - removed the `warning` enum value from the `meta/warnings/anyOf[subschema #1]/items/type` response property for the response status `500`
  - removed the `warning` enum value from the `meta/warnings/anyOf[subschema #1]/items/type` response property for the response status `501`
  - removed the `warning` enum value from the `meta/warnings/anyOf[subschema #1]/items/type` response property for the response status `553`
- **2024-09-16** `9b788cdaec23`: 10 breaking, 109 info
  - for the `query` request parameter `email_address`, default value `` was removed
  - the `included/anyOf[subschema #1]/items/attributes` response's property type changed from no type to `object` for status `200`
  - the `meta` response's property type changed from no type to `object` for status `200`
  - the `meta` response's property type changed from no type to `object` for status `400`
  - the `meta` response's property type changed from no type to `object` for status `403`
  - the `meta` response's property type changed from no type to `object` for status `404`
  - the `meta` response's property type changed from no type to `object` for status `422`
  - the `meta` response's property type changed from no type to `object` for status `500`
  - the `meta` response's property type changed from no type to `object` for status `501`
  - the `meta` response's property type changed from no type to `object` for status `553`
  - `query` request parameter `email_address` list-of-types was widened by adding types `null`
  - for the `query` request parameter `email_address`, the type was generalized from `string` to no type, and format from `email` to no format
  - added the optional property `included/anyOf[subschema #1]/items/attributes/immutable_id` to the response with the `200` status
  - added the optional property `meta/data_available` to the response with the `200` status
  - added the optional property `meta/data_available` to the response with the `400` status
  - added the optional property `meta/data_available` to the response with the `403` status
  - added the optional property `meta/data_available` to the response with the `404` status
  - added the optional property `meta/data_available` to the response with the `422` status
  - added the optional property `meta/data_available` to the response with the `500` status
  - added the optional property `meta/data_available` to the response with the `501` status
  - added the optional property `meta/data_available` to the response with the `553` status
  - added the optional property `meta/data_returned` to the response with the `200` status
  - added the optional property `meta/data_returned` to the response with the `400` status
  - added the optional property `meta/data_returned` to the response with the `403` status
  - added the optional property `meta/data_returned` to the response with the `404` status
  - added the optional property `meta/data_returned` to the response with the `422` status
  - added the optional property `meta/data_returned` to the response with the `500` status
  - added the optional property `meta/data_returned` to the response with the `501` status
  - added the optional property `meta/data_returned` to the response with the `553` status
  - added the optional property `meta/implementation` to the response with the `200` status
  - added the optional property `meta/implementation` to the response with the `400` status
  - added the optional property `meta/implementation` to the response with the `403` status
  - added the optional property `meta/implementation` to the response with the `404` status
  - added the optional property `meta/implementation` to the response with the `422` status
  - added the optional property `meta/implementation` to the response with the `500` status
  - added the optional property `meta/implementation` to the response with the `501` status
  - added the optional property `meta/implementation` to the response with the `553` status
  - added the optional property `meta/last_id` to the response with the `200` status
  - added the optional property `meta/last_id` to the response with the `400` status
  - added the optional property `meta/last_id` to the response with the `403` status
  - …79 more
- **2024-05-13** `be1576bbcbb8`: 9 breaking, 9 warning
  - the `data/anyOf[subschema #1]/items/type` response's property type changed from no type to `string` for status `200`
  - the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response's property type changed from no type to `string` for status `200`
  - the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response's property type changed from no type to `string` for status `400`
  - the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response's property type changed from no type to `string` for status `403`
  - the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response's property type changed from no type to `string` for status `404`
  - the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response's property type changed from no type to `string` for status `422`
  - the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response's property type changed from no type to `string` for status `500`
  - the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response's property type changed from no type to `string` for status `501`
  - the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response's property type changed from no type to `string` for status `553`
  - added the new `structures` enum value to the `data/anyOf[subschema #1]/items/type` response property for the response status `200`
  - added the new `warning` enum value to the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response property for the response status `200`
  - added the new `warning` enum value to the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response property for the response status `400`
  - added the new `warning` enum value to the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response property for the response status `403`
  - added the new `warning` enum value to the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response property for the response status `404`
  - added the new `warning` enum value to the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response property for the response status `422`
  - added the new `warning` enum value to the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response property for the response status `500`
  - added the new `warning` enum value to the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response property for the response status `501`
  - added the new `warning` enum value to the `meta/allOf[subschema #1: ResponseMeta]/warnings/anyOf[subschema #1]/items/type` response property for the response status `553`
- **2023-10-23** `8745068d2592`: 127 breaking, 215 info
  - the response property `data/anyOf[subschema #1]/items/attributes/cartesian_site_positions` became optional for the status `200`
  - the response property `data/anyOf[subschema #1]/items/attributes/chemical_formula_anonymous` became optional for the status `200`
  - the response property `data/anyOf[subschema #1]/items/attributes/chemical_formula_descriptive` became optional for the status `200`
  - the response property `data/anyOf[subschema #1]/items/attributes/chemical_formula_reduced` became optional for the status `200`
  - the response property `data/anyOf[subschema #1]/items/attributes/dimension_types` became optional for the status `200`
  - the response property `data/anyOf[subschema #1]/items/attributes/elements` became optional for the status `200`
  - the response property `data/anyOf[subschema #1]/items/attributes/elements_ratios` became optional for the status `200`
  - the response property `data/anyOf[subschema #1]/items/attributes/lattice_vectors` became optional for the status `200`
  - the response property `data/anyOf[subschema #1]/items/attributes/nelements` became optional for the status `200`
  - the response property `data/anyOf[subschema #1]/items/attributes/nperiodic_dimensions` became optional for the status `200`
  - the response property `data/anyOf[subschema #1]/items/attributes/nsites` became optional for the status `200`
  - the response property `data/anyOf[subschema #1]/items/attributes/species` became optional for the status `200`
  - the response property `data/anyOf[subschema #1]/items/attributes/species_at_sites` became optional for the status `200`
  - response property `data/anyOf[subschema #1]/items/attributes/assemblies` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/cartesian_site_positions` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/chemical_formula_anonymous` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/chemical_formula_descriptive` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/chemical_formula_hill` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/chemical_formula_reduced` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/dimension_types` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/elements` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/elements_ratios` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/immutable_id` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/last_modified` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/lattice_vectors` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/nelements` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/nperiodic_dimensions` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/nsites` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/species` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `data/anyOf[subschema #1]/items/attributes/species_at_sites` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `errors` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `200`
  - response property `errors/items/code` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `400`
  - response property `errors/items/code` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `403`
  - response property `errors/items/code` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `404`
  - response property `errors/items/code` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `422`
  - response property `errors/items/code` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `500`
  - response property `errors/items/code` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `501`
  - response property `errors/items/code` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `553`
  - response property `errors/items/id` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `400`
  - response property `errors/items/id` list-of-types was widened by adding types `null` to media type `application/vnd.api+json` of response `403`
  - …302 more
- **2023-02-27** `95e421fb52e9`: 2 breaking, 2 info
  - for the `query` request parameter `page_above`, default value `0` was removed
  - for the `query` request parameter `page_below`, default value `0` was removed
  - for the `query` request parameter `page_above`, the type was generalized from `integer` to `string`
  - for the `query` request parameter `page_below`, the type was generalized from `integer` to `string`
- **2022-12-08** `101424246724`: 3 info
  - the `data/anyOf[subschema #1]/items/attributes/chemical_formula_anonymous` response's property pattern was changed from `^([A-Z][a-z]?([2-9]|[1-9]\d+)?)+$` to `(^$)|^([A-Z][a-z]?([2-9]|[1-9]\d+)?)+$` for the status `200`
  - the `data/anyOf[subschema #1]/items/attributes/chemical_formula_hill` response's property pattern was changed from `^([A-Z][a-z]?([2-9]|[1-9]\d+)?)+$` to `(^$)|^([A-Z][a-z]?([2-9]|[1-9]\d+)?)+$` for the status `200`
  - the `data/anyOf[subschema #1]/items/attributes/chemical_formula_reduced` response's property pattern was changed from `^([A-Z][a-z]?([2-9]|[1-9]\d+)?)+$` to `(^$)|^([A-Z][a-z]?([2-9]|[1-9]\d+)?)+$` for the status `200`

---

[Operation](https://skmtc.dev/materials-consortia/apis/optimade-api/docs/structures/get.md) - [API](https://skmtc.dev/materials-consortia/apis/optimade-api.md) - [Page](https://skmtc.dev/materials-consortia/apis/optimade-api/changes/structures/get)