---
title: "Read Mmcif"
method: POST
path: "/convert/mmcif_file_to_protein"
tags: ["convert"]
---

# Read Mmcif

`POST /convert/mmcif_file_to_protein`

## Request

- Base URL: `https://api.rowansci.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rowansci.com/convert/mmcif_file_to_protein`
- Auth: none declared
- TypeScript: <https://skmtc.dev/rowansci/apis/eyrie/docs/convert/mmcif_file_to_protein/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- File
  - `name` string, required
  - `text` string, required

## Response `200`

Successful Response

- PDBOutput: Parsed PDB or mmCIF structure. Attributes: description: deposition metadata experiment: experimental metadata geometry: assemblies and crystallographic geometry models: coordinate models in the structure quality: experimental quality metrics
  - `description` PDBDescription, required: Description of the deposited structure. Attributes: code: Protein Data Bank identifier title: title of the deposited structure authors: authors of the deposited structure classification: structure classification deposition_date: date the structure was deposited keywords: keywords describing the structure
    - `code` string, nullable
    - `title` string, nullable
    - `authors` string[]
    - `classification` string, nullable
    - `deposition_date` string, nullable
    - `keywords` string[]
  - `experiment` PDBExperiment, required: Details of the experiment. Attributes: expression_system: organism or system used to express the sample missing_residues: residues absent from the resolved structure source_organism: organism from which the sample originated technique: experimental structure determination method
    - `expression_system` string, nullable
    - `missing_residues` PDBMissingResidue[]
      - `name` string, required
      - `id` string, required
    - `source_organism` string, nullable
    - `technique` string, nullable
  - `geometry` PDBGeometryOutput, required: Details of the geometry. Attributes: assemblies: biological assemblies described for the structure crystallography: crystallographic information
    - `assemblies` PDBAssembly[]
      - `transformations` PDBTransformations[], required
        - `chains` string[], required
        - `matrix` unknown[], required
          - unknown
        - `vector` unknown[], required
          - unknown
      - `software` string, nullable
      - `buried_surface_area` number, nullable
      - `surface_area` number, nullable
      - `delta_energy` number, nullable
      - `id` integer, required
    - `crystallography` PDBCrystallography: Crystallography related information. Attributes: space_group: crystallographic space group unit_cell: crystallographic unit cell
      - `space_group` string, nullable
      - `unit_cell` number[], nullable
  - `models` PDBModelOutput[]
    - `polymer` object
    - `non_polymer` object
    - `branched` object
    - `water` object
    - `connections` array[]
      - integer[]
  - `quality` PDBQuality: Quality metrics. Attributes: resolution: experimental structure resolution, in Å rfree: free R factor rvalue: refinement R factor
    - `resolution` number, nullable
    - `rfree` number, nullable
    - `rvalue` number, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/rowansci/apis/eyrie.md) - [All operations](https://skmtc.dev/rowansci/apis/eyrie/llms.txt) - [OpenAPI document](https://skmtc.dev/rowansci/apis/eyrie/revisions/11711cda3e1b?raw)