diff --git a/biblio-tools/examples.http b/biblio-tools/examples.http
index cb1fb09..98180f9 100644
--- a/biblio-tools/examples.http
+++ b/biblio-tools/examples.http
@@ -39,3 +39,19 @@
   { "value": "10.1037"}
 ]
 ###
+
+
+
+# crossref/pref
+POST https://biblio-tools.services.inist.fr/v1/crossref/prefixes/expand?indent=true HTTP/1.1
+Content-Type: application/json
+
+[
+  { "value": "10.1016/j.fuel.2018.07.071" },
+  { "value": "10.1007/s10980-018-0699-8" },
+  { "value": "10.1159/000490004" },
+  { "value": "10.1016/j.memsci.2018.08.024"},
+  { "value": "10.1029/2018jd029272"}
+]
+###
+
diff --git a/biblio-tools/swagger.json b/biblio-tools/swagger.json
new file mode 100755
index 0000000..a1424e2
--- /dev/null
+++ b/biblio-tools/swagger.json
@@ -0,0 +1,44 @@
+{
+  "servers": [
+    {
+      "url": "{scheme}://{hostname}",
+      "variables": {
+        "scheme": {
+          "default": "https"
+        }
+      }
+    }
+  ],
+  "tags": [
+    {
+      "name": "bibliography",
+      "description": "Bibliographie",
+      "externalDocs": {
+        "description": "Plus de documentation",
+        "url": "https://gitbucket.inist.fr/tdm/web-services/tree/master/bilbio-tools"
+      }
+    }
+  ],
+  "components": {
+    "schemas": {
+      "IdDOIList": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/IdDOIItem"
+        }
+      },
+      "IdDOIItem": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "integer"
+          },
+          "value": {
+            "type": "string",
+            "example": "10.4000/edc.9014"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/biblio-tools/v1/crossref/prefixes/expand.ini b/biblio-tools/v1/crossref/prefixes/expand.ini
index 61664c0..f8de20e 100644
--- a/biblio-tools/v1/crossref/prefixes/expand.ini
+++ b/biblio-tools/v1/crossref/prefixes/expand.ini
@@ -1,3 +1,15 @@
+# OpenAPI Documentation - JSON format (dot notation)
+mimeType = application/json
+
+post.operationId = post-v1-crossref-prefixes-expand
+post.description = Verbalisation du préfix DOI à partir d'un DOI complet ou just eà partir du préfixe
+post.tags.0 = bibliography
+post.responses.default.description = Renvoit une liste d'objet reçu avec le champ 'value' modifié
+post.summary = Verbalisatino à partir d'un tableau d'objets contenant à minima le champ value
+post.requestBody.required = true
+post.requestBody.content.application/json.schema.$ref = #/components/schemas/IdDOIList
+
+
 # Necessary plugins
 [use]
 plugin = basics