Skip to content
GET /v1/structure

A crystal structure: cell, space group, citation

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/cod-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/cod-api/v1/structure" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/cod-api/v1/structure", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/cod-api/v1/structure");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/cod-api/v1/structure",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "structure": {
            "doi": "10.1107/S010876810503747X",
            "url": "https://www.crystallography.net/cod/2100348.html",
            "cell": {
                "a": 7.287,
                "b": 9.2,
                "c": 6.688,
                "beta": 90,
                "alpha": 90,
                "gamma": 90,
                "volume": 448.4
            },
            "year": 2006,
            "title": "Pressure-frozen benzene I revisited",
            "cod_id": "2100348",
            "authors": "Budzianowski, Armand; Katrusiak, Andrzej",
            "cif_url": "https://www.crystallography.net/cod/2100348.cif",
            "formula": "C6 H6",
            "journal": "Acta Crystallographica Section B",
            "mineral": null,
            "space_group": "P b c a",
            "cell_formula": "C24 H24",
            "space_group_hall": "-P 2ac 2ab"
        }
    },
    "meta": {
        "timestamp": "2026-06-01T16:23:15.049Z",
        "request_id": "dee10794-9954-4650-9f50-7968f026293c"
    },
    "status": "ok",
    "message": "Structure retrieved",
    "success": true
}