Differences

This shows you the differences between two versions of the page.

--- api [2026/01/17 13:00] – [Quote Request] flack
+++ api [2026/03/02 13:15] (current) – [Rate limits] flack
@@ Line 18: / Line 18: @@
 If you make a lot of API requests then you may receive a 429 Too Many Requests response. This indicates that an API rate limit has been reached.
+You can check the "Retry-After" response header or message in the response body to determine how long you have to wait with your next request without being rate limited.
 If you need higher API rate limits please get in touch with us.
 Please note that we might refine the existing rate limits or introduce new ones in the future in order to keep our API reliable and to help third-party developers use the API in a responsible way.
 ===== Default rate limits =====
@@ Line 187: / Line 191: @@
 If you call this API endpoint as an authenticated user (=you provide a [[api#authentication|valid token]]) you might get additional private entries if you have permission to access them.
+You can get a single database file by its ID:
+== Endpoint: ==
+<code>/database-files/<id>/</code>
+== Example API request: ==
+<code>
+http https://mcule.com/api/v1/database-files/1/ --print HBhb
+</code>
+== Request: ==
+<code>
+GET /api/v1/database-files/1/ HTTP/1.1
+Accept: */*
+Accept-Encoding: gzip, deflate
+</code>
+== Response: ==
+<code>
+HTTP/1.1 200 OK
+Allow: GET, HEAD, OPTIONS
+Content-Type: application/json
+{
+  "count": 1,
+  "next": null,
+  "previous": null,
+  "results": [
+    {
+      "id": 1,
+      "name": "Mcule Full",
+      "description": "Purchasable Mcule supplier & ULTIMATE catalogs",
+      "entry_count": 139650179,
+      "last_updated": "2026-01-29",
+      "files": [
+        {
+          "id": 28,
+          "size_mb": 31039,
+          "file_type": "sdf.gz",
+          "file_type_display": "2D SDF (sdf.gz)",
+          "download_url": "https://dl.mcule.com/database/mcule_purchasable_full_260129.sdf.gz",
+          "filename": "mcule_purchasable_full_260129.sdf.gz",
+          "sha256_checksum": "5222e0d4b0b2886c372e971d1f720a2ebde280bc7eefa893d79b2231460d9551"
+        },
+        {
+          "id": 32,
+          "size_mb": 2396,
+          "file_type": "smi.gz",
+          "file_type_display": "SMILES (smi.gz)",
+          "download_url": "https://dl.mcule.com/database/mcule_purchasable_full_260129.smi.gz",
+          "filename": "mcule_purchasable_full_260129.smi.gz",
+          "sha256_checksum": "f9af6934f1b4dcfe40b0c52734637d1fa50c920d1c488c33ee16c04b23df8049"
+        }
+      ],
+      "public": true,
+      "group": "default"
+    }
+  ]
+}
+</code>
 ===== Compound details =====