---
title: "Get MoleculesDoc documents"
method: GET
path: "/molecules/jcesr/"
tags: ["JCESR Electrolyte Genome"]
---

# Get MoleculesDoc documents

`GET /molecules/jcesr/`

## Query parameters

- `nelements_max` number, nullable — Maximum value for the number of elements.
- `nelements_min` number, nullable — Minimum value for the number of elements.
- `EA_max` number, nullable — Maximum value for the electron affinity in eV.
- `EA_min` number, nullable — Minimum value for the electron affinity in eV.
- `IE_max` number, nullable — Maximum value for the ionization energy in eV.
- `IE_min` number, nullable — Minimum value for the ionization energy in eV.
- `charge_max` integer, nullable — Maximum value for the charge in +e.
- `charge_min` integer, nullable — Minimum value for the charge in +e.
- `pointgroup` string, nullable — Point of the molecule in Schoenflies notation.
- `smiles` string, nullable — The simplified molecular input line-entry system (SMILES) representation of the molecule.
- `elements` string, nullable — Query by elements in the material composition as a comma-separated list
- `formula` string, nullable — Chemical formula of the molecule. A comma-separated list of formulas is also accepted.
- `task_ids` string, nullable — Comma-separated list of task_ids to query on
- `_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.
- `_sort_fields` string, nullable — Comma delimited fields to sort with. Prefixing '-' to a field will force a sort in descending order.
- `_fields` string — Fields to project from MoleculesDoc as a list of comma separated strings. Fields include: `elements` `nelements` `EA` `IE` `charge` `pointgroup` `smiles` `task_id` `molecule` `formula_pretty` `svg`
- `_all_fields` boolean — Include all fields.

## Response `200`

Search for a MoleculesDoc

- ResponseMoleculesDoc
  - `data` MoleculesDoc[], nullable — List of returned data
    - `elements` Element[], nullable — List of elements in the molecule.
    - `nelements` integer, nullable — Number of elements in the molecule.
    - `EA` number, nullable — Electron affinity of the molecule in eV.
    - `IE` number, nullable — Ionization energy of the molecule in eV.
    - `charge` integer, nullable — Charge of the molecule in +e.
    - `pointgroup` string, nullable — Point group of the molecule in Schoenflies notation.
    - `smiles` string, nullable — The simplified molecular input line-entry system (SMILES) representation of the molecule.
    - `task_id` string, nullable — Materials Project molecule ID. This takes the form mol-*****.
    - `molecule` TypedMoleculeDict
      - `@module` string, required
      - `@class` string, required
      - `charge` number, required
      - `spin_multiplicity` integer, required
      - `sites` TypedSiteDict[], required — unresolved $ref
      - `properties` TypedAggregateProperitesDict, required
        - `magmom` number[], nullable
        - `charge` number[], nullable
        - `velocities` array[], nullable
          - unknown[]
            - unknown
        - `selective_dynamics` array[], nullable
          - unknown[]
            - unknown
    - `formula_pretty` string, nullable — Chemical formula of the molecule.
    - `svg` string, nullable — String representation of the SVG image of the molecule.
  - `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/molecules/jcesr/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)