---
title: "Post FindStructure documents"
method: POST
path: "/materials/core/find_structure/"
tags: ["Materials"]
---

# Post FindStructure documents

`POST /materials/core/find_structure/`

## Query parameters

- `ltol` number — Fractional length tolerance. Default is 0.2.
- `stol` number — Site tolerance. Defined as the fraction of the average free length per atom := ( V / Nsites ) ** (1/3). Default is 0.3.
- `angle_tol` number — Angle tolerance in degrees. Default is 5 degrees.
- `_limit` integer — Maximum number of matches to show. Defaults to 1, only showing the best match.

## Request body

- object — Dictionary representaion of Pymatgen structure object to query with

## Response `200`

Post FindStructure data

- ResponseFindStructure
  - `data` FindStructure[], nullable — List of returned data
    - `material_id` unknown
    - `normalized_rms_displacement` number, nullable — Volume normalized root-mean squared displacement between the structures
    - `max_distance_paired_sites` number, nullable — Maximum distance between paired sites.
  - `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; 2 could not be searched.

- **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/core/find_structure/post.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)