Differences

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

--- api [2026/01/17 12:52] – 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 32: / Line 38: @@
 === For authenticated requests ===
-If you use a valid API access token the following limits apply:
+If you use a valid API access token, the following limits apply:
   * Burst: 20/min
@@ Line 39: / Line 45: @@
 ===== Special rate limits =====
-If an endpoint is not listed in this section then the default rate limits apply for that endpoint.
+If an endpoint is not listed in this section, the default rate limits apply for that endpoint.
 === Compound list details ===
@@ Line 185: / 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 =====
@@ Line 1151: / Line 1217: @@
 Mandatory fields:
-  * **mcule_ids**: List of mcule IDs of structures you want get a quote for.
+  * **mcule_ids**: List of mcule IDs of structures you want get a quote for. The maximum number of valid IDs allowed here is 1000 by default. Contact us if you need more.
   * **customer_first_name**: The customer's first name. It does not need to be specified if the user's first name is specified on the Edit profile page on mcule.com.
   * **customer_last_name**: The customer's last name. It does not need to be specified if the user's last name is specified on the Edit profile page on mcule.com.
-  * **delivery_country**: ISO 3166-1 alpha-2 code of the delivery country.
+  * **delivery_country**: ISO 3166-1 alpha-2 code of the delivery country. [[https://www.iso.org/obp/ui#search]]