From d7fa344b7d42c80d4751bc9af643db2ff733511c Mon Sep 17 00:00:00 2001
From: Luca Frosini <luca.frosini@isti.cnr.it>
Date: Wed, 10 Apr 2024 17:43:22 +0200
Subject: [PATCH] Added documentation

---
 .../grsf/publisher/rest/FisheryRESTAPIs.java  |  35 +-
 .../grsf/publisher/rest/StockRESTAPIs.java    |  35 +-
 .../rest/TraceabilityUnitRESTAPIs.java        |  35 +-
 .../fishery/create-fishery-request.json       |  29 ++
 .../fishery/create-fishery-response.json      | 240 +++++++++
 .../fishery/read-fishery-response.json        | 240 +++++++++
 .../stock/create-stock-request.json           | 104 ++++
 .../stock/create-stock-response.json          | 490 ++++++++++++++++++
 .../stock/read-stock-response.json            | 490 ++++++++++++++++++
 .../create-traceability-unit-request.json     |  26 +
 .../create-traceability-unit-response.json    | 251 +++++++++
 .../read-traceability-unit-response.json      | 251 +++++++++
 .../grsf/publisher/record/RecordTest.java     |  12 +-
 13 files changed, 2211 insertions(+), 27 deletions(-)
 create mode 100644 src/main/resources/api-docs-examples/fishery/create-fishery-request.json
 create mode 100644 src/main/resources/api-docs-examples/fishery/create-fishery-response.json
 create mode 100644 src/main/resources/api-docs-examples/fishery/read-fishery-response.json
 create mode 100644 src/main/resources/api-docs-examples/stock/create-stock-request.json
 create mode 100644 src/main/resources/api-docs-examples/stock/create-stock-response.json
 create mode 100644 src/main/resources/api-docs-examples/stock/read-stock-response.json
 create mode 100644 src/main/resources/api-docs-examples/traceability-unit/create-traceability-unit-request.json
 create mode 100644 src/main/resources/api-docs-examples/traceability-unit/create-traceability-unit-response.json
 create mode 100644 src/main/resources/api-docs-examples/traceability-unit/read-traceability-unit-response.json

diff --git a/src/main/java/org/gcube/grsf/publisher/rest/FisheryRESTAPIs.java b/src/main/java/org/gcube/grsf/publisher/rest/FisheryRESTAPIs.java
index 1efd4d5..2405c40 100644
--- a/src/main/java/org/gcube/grsf/publisher/rest/FisheryRESTAPIs.java
+++ b/src/main/java/org/gcube/grsf/publisher/rest/FisheryRESTAPIs.java
@@ -17,7 +17,6 @@ import org.gcube.grsf.publisher.annotation.PATCH;
 import org.gcube.grsf.publisher.annotation.PURGE;
 import org.gcube.grsf.publisher.ckan.record.FisheryRecord;
 
-import com.webcohesion.enunciate.metadata.Label;
 import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
 import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
 import com.webcohesion.enunciate.metadata.rs.ResponseCode;
@@ -41,7 +40,7 @@ public class FisheryRESTAPIs extends BaseRESTAPIs<FisheryRecord> {
 	/**
 	 * <p>
 	 * 	The listing API provides paginated results by using the query parameters limit and offset.<br/>
-	 * 	It returns an array list of string containing the GRSF UUIDs of the records.<br/>
+	 * 	It returns an array list of string containing the GRSF UUIDs of the fishery records.<br/>
 	 * 	Each name can be used as <code>{fishery_record_id}</code> path parameter to manage such a record.
 	 * </p>
 	 * 
@@ -184,7 +183,11 @@ public class FisheryRESTAPIs extends BaseRESTAPIs<FisheryRecord> {
 	}
 	
 	/**
+	 * This API allows to create a fishery record
 	 * @pathExample /fishery
+	 * 
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/fishery/create-fishery-request.json
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/fishery/create-fishery-response.json
 	 */
 	@POST
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
@@ -197,7 +200,9 @@ public class FisheryRESTAPIs extends BaseRESTAPIs<FisheryRecord> {
 	}
 	
 	/**
-	 * @pathExample /fishery/bc26e8d0-6ab3-4547-9922-d40407fc5dbd
+	 * This API allows to read a fishery record
+	 * @pathExample /fishery/d0145931-58d3-4561-bf64-363b61df016b
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/fishery/read-fishery-response.json
 	 */
 	@GET
 	@Path("/{" + GRSF_RECORD_UUID_PARAMETER + "}")
@@ -211,7 +216,10 @@ public class FisheryRESTAPIs extends BaseRESTAPIs<FisheryRecord> {
 	}
 	
 	/**
-	 * @pathExample /fishery/bc26e8d0-6ab3-4547-9922-d40407fc5dbd
+	 * This API allows to update a fishery record
+	 * @pathExample /fishery/d0145931-58d3-4561-bf64-363b61df016b
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/fishery/create-fishery-request.json
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/fishery/create-fishery-response.json
 	 */
 	@PUT
 	@Path("/{" + GRSF_RECORD_UUID_PARAMETER + "}")
@@ -226,7 +234,13 @@ public class FisheryRESTAPIs extends BaseRESTAPIs<FisheryRecord> {
 	}
 	
 	/**
-	 * @pathExample /fishery/bc26e8d0-6ab3-4547-9922-d40407fc5dbd
+	 * This API allows to patch a fishery record.
+	 * The service only updates the provided properties and, 
+	 * eventually, creates resources (e.g., time series) and 
+	 * adds tags or groups to the records.
+	 * The API does not guarantee that the record is removed from an 
+	 * old group/tag associated due to the old property value.
+	 * @pathExample /fishery/d0145931-58d3-4561-bf64-363b61df016b
 	 */
 	@PATCH
 	@Path("/{" + GRSF_RECORD_UUID_PARAMETER + "}")
@@ -241,7 +255,12 @@ public class FisheryRESTAPIs extends BaseRESTAPIs<FisheryRecord> {
 	}
 	
 	/**
-	 * @pathExample /fishery/bc26e8d0-6ab3-4547-9922-d40407fc5dbd
+	 * This API allows to delete/purge (when the purge query parameter is true) 
+	 * a fishery record.
+	 * In case of delete, the fishery record is no longer visible, 
+	 * but it still exists and can be restored.
+	 * In case of purge, the record is completely deleted and cannot be restored.
+	 * @pathExample /fishery/d0145931-58d3-4561-bf64-363b61df016b?purge=true
 	 */
 	@DELETE
 	@Path("/{" + GRSF_RECORD_UUID_PARAMETER + "}")
@@ -256,7 +275,9 @@ public class FisheryRESTAPIs extends BaseRESTAPIs<FisheryRecord> {
 	}
 	
 	/**
-	 * @pathExample /fishery/bc26e8d0-6ab3-4547-9922-d40407fc5dbd
+	 * This API allows to purge a fishery record.
+	 * The record cannot be restored.
+	 * @pathExample /fishery/d0145931-58d3-4561-bf64-363b61df016b
 	 */
 	@PURGE
 	@Path("/{" + GRSF_RECORD_UUID_PARAMETER + "}")
diff --git a/src/main/java/org/gcube/grsf/publisher/rest/StockRESTAPIs.java b/src/main/java/org/gcube/grsf/publisher/rest/StockRESTAPIs.java
index fc129ca..40e4d07 100644
--- a/src/main/java/org/gcube/grsf/publisher/rest/StockRESTAPIs.java
+++ b/src/main/java/org/gcube/grsf/publisher/rest/StockRESTAPIs.java
@@ -17,7 +17,6 @@ import org.gcube.grsf.publisher.annotation.PATCH;
 import org.gcube.grsf.publisher.annotation.PURGE;
 import org.gcube.grsf.publisher.ckan.record.StockRecord;
 
-import com.webcohesion.enunciate.metadata.Label;
 import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
 import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
 import com.webcohesion.enunciate.metadata.rs.ResponseCode;
@@ -41,7 +40,7 @@ public class StockRESTAPIs extends BaseRESTAPIs<StockRecord> {
 	/**
 	 * <p>
 	 * 	The listing API provides paginated results by using the query parameters limit and offset.<br/>
-	 * 	It returns an array list of string containing the GRSF UUIDs of the records.<br/>
+	 * 	It returns an array list of string containing the GRSF UUIDs of the stock records.<br/>
 	 * 	Each name can be used as <code>{stock_record_id}</code> path parameter to manage such a record.
 	 * </p>
 	 * 
@@ -184,7 +183,11 @@ public class StockRESTAPIs extends BaseRESTAPIs<StockRecord> {
 	}
 	
 	/**
+	 * This API allows to create a stock record
 	 * @pathExample /stock
+	 * 
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/stock/create-stock-request.json
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/stock/create-stock-response.json
 	 */
 	@POST
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
@@ -197,7 +200,9 @@ public class StockRESTAPIs extends BaseRESTAPIs<StockRecord> {
 	}
 	
 	/**
-	 * @pathExample /stock/866a479a-643a-4c21-bbcd-a3a73f28ea50
+	 * This API allows to read a stock record
+	 * @pathExample /stock/23fd6734-b7cd-37eb-8b43-03b1495dd7af
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/stock/read-stock-response.json
 	 */
 	@GET
 	@Path("/{" + RECORD_ID_PARAMETER + "}")
@@ -211,7 +216,10 @@ public class StockRESTAPIs extends BaseRESTAPIs<StockRecord> {
 	}
 	
 	/**
-	 * @pathExample /stock/866a479a-643a-4c21-bbcd-a3a73f28ea50
+	 * This API allows to update a stock record
+	 * @pathExample /stock/23fd6734-b7cd-37eb-8b43-03b1495dd7af
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/fishery/create-fishery-request.json
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/fishery/create-fishery-response.json
 	 */
 	@PUT
 	@Path("/{" + RECORD_ID_PARAMETER + "}")
@@ -226,7 +234,13 @@ public class StockRESTAPIs extends BaseRESTAPIs<StockRecord> {
 	}
 	
 	/**
-	 * @pathExample /stock/866a479a-643a-4c21-bbcd-a3a73f28ea50
+	 * This API allows to patch a stock record.
+	 * The service only updates the provided properties and, 
+	 * eventually, creates resources (e.g., time series) and 
+	 * adds tags or groups to the records.
+	 * The API does not guarantee that the record is removed from an 
+	 * old group/tag associated due to the old property value.
+	 * @pathExample /stock/23fd6734-b7cd-37eb-8b43-03b1495dd7af
 	 */
 	@PATCH
 	@Path("/{" + RECORD_ID_PARAMETER + "}")
@@ -241,7 +255,12 @@ public class StockRESTAPIs extends BaseRESTAPIs<StockRecord> {
 	}
 	
 	/**
-	 * @pathExample /stock/866a479a-643a-4c21-bbcd-a3a73f28ea50
+	 * This API allows to delete/purge (when the purge query parameter is true) 
+	 * a stock record.
+	 * In case of delete, the stock record is no longer visible, 
+	 * but it still exists and can be restored.
+	 * In case of purge, the record is completely deleted and cannot be restored.
+	 * @pathExample /stock/23fd6734-b7cd-37eb-8b43-03b1495dd7af
 	 */
 	@DELETE
 	@Path("/{" + RECORD_ID_PARAMETER + "}")
@@ -256,7 +275,9 @@ public class StockRESTAPIs extends BaseRESTAPIs<StockRecord> {
 	}
 	
 	/**
-	 * @pathExample /stock/866a479a-643a-4c21-bbcd-a3a73f28ea50
+	 * This API allows to purge a stock record.
+	 * The record cannot be restored.
+	 * @pathExample /stock/23fd6734-b7cd-37eb-8b43-03b1495dd7af
 	 */
 	@PURGE
 	@Path("/{" + RECORD_ID_PARAMETER + "}")
diff --git a/src/main/java/org/gcube/grsf/publisher/rest/TraceabilityUnitRESTAPIs.java b/src/main/java/org/gcube/grsf/publisher/rest/TraceabilityUnitRESTAPIs.java
index 442238d..fcdc849 100644
--- a/src/main/java/org/gcube/grsf/publisher/rest/TraceabilityUnitRESTAPIs.java
+++ b/src/main/java/org/gcube/grsf/publisher/rest/TraceabilityUnitRESTAPIs.java
@@ -17,7 +17,6 @@ import org.gcube.grsf.publisher.annotation.PATCH;
 import org.gcube.grsf.publisher.annotation.PURGE;
 import org.gcube.grsf.publisher.ckan.record.TraceabilityUnitRecord;
 
-import com.webcohesion.enunciate.metadata.Label;
 import com.webcohesion.enunciate.metadata.rs.ResourceGroup;
 import com.webcohesion.enunciate.metadata.rs.ResourceLabel;
 import com.webcohesion.enunciate.metadata.rs.ResponseCode;
@@ -41,7 +40,7 @@ public class TraceabilityUnitRESTAPIs extends BaseRESTAPIs<TraceabilityUnitRecor
 	/**
 	 * <p>
 	 * 	The listing API provides paginated results by using the query parameters limit and offset.<br/>
-	 * 	It returns an array list of string containing the GRSF UUIDs of the records.<br/>
+	 * 	It returns an array list of string containing the GRSF UUIDs of the traceability unit records.<br/>
 	 * 	Each name can be used as <code>{traceability_unit_record_id}</code> path parameter to manage such a record.
 	 * </p>
 	 * 
@@ -184,7 +183,11 @@ public class TraceabilityUnitRESTAPIs extends BaseRESTAPIs<TraceabilityUnitRecor
 	}
 	
 	/**
+	 * This API allows to create a traceability unit record
 	 * @pathExample /traceability-unit
+	 * 
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/traceability-unit/create-traceability-unit-request.json
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/traceability-unit/create-traceability-unit-response.json
 	 */
 	@POST
 	@Consumes(GCatConstants.APPLICATION_JSON_CHARSET_UTF_8)
@@ -197,7 +200,9 @@ public class TraceabilityUnitRESTAPIs extends BaseRESTAPIs<TraceabilityUnitRecor
 	}
 	
 	/**
-	 * @pathExample /traceability-unit/004d6fd2-3e49-4246-b321-f768efdaa7b6
+	 * This API allows to read a traceability unit record
+	 * @pathExample /traceability-unit/00454650-b66c-32f9-ae32-eff038dd1e1d
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/traceability-unit/read-traceability-unit-response.json
 	 */
 	@GET
 	@Path("/{" + RECORD_ID_PARAMETER + "}")
@@ -211,7 +216,10 @@ public class TraceabilityUnitRESTAPIs extends BaseRESTAPIs<TraceabilityUnitRecor
 	}
 	
 	/**
-	 * @pathExample /traceability-unit/004d6fd2-3e49-4246-b321-f768efdaa7b6
+	 * This API allows to update a traceability unit record
+	 * @pathExample /traceability-unit/00454650-b66c-32f9-ae32-eff038dd1e1d
+	 * @requestExample application/json;charset=UTF-8 classpath:/api-docs-examples/traceability-unit/create-traceability-unit-request.json
+	 * @responseExample application/json;charset=UTF-8 classpath:/api-docs-examples/traceability-unit/create-traceability-unit-response.json
 	 */
 	@PUT
 	@Path("/{" + RECORD_ID_PARAMETER + "}")
@@ -226,7 +234,13 @@ public class TraceabilityUnitRESTAPIs extends BaseRESTAPIs<TraceabilityUnitRecor
 	}
 	
 	/**
-	 * @pathExample /traceability-unit/004d6fd2-3e49-4246-b321-f768efdaa7b6
+	 * This API allows to patch a traceability unit record.
+	 * The service only updates the provided properties and, 
+	 * eventually, creates resources (e.g., time series) and 
+	 * adds tags or groups to the records.
+	 * The API does not guarantee that the record is removed from an 
+	 * old group/tag associated due to the old property value.
+	 * @pathExample /traceability-unit/00454650-b66c-32f9-ae32-eff038dd1e1d
 	 */
 	@PATCH
 	@Path("/{" + RECORD_ID_PARAMETER + "}")
@@ -241,7 +255,12 @@ public class TraceabilityUnitRESTAPIs extends BaseRESTAPIs<TraceabilityUnitRecor
 	}
 	
 	/**
-	 * @pathExample /traceability-unit/004d6fd2-3e49-4246-b321-f768efdaa7b6
+	 * This API allows to delete/purge (when the purge query parameter is true) 
+	 * a traceability unit record.
+	 * In case of delete, the traceability unit record is no longer visible, 
+	 * but it still exists and can be restored.
+	 * In case of purge, the record is completely deleted and cannot be restored.
+	 * @pathExample /traceability-unit/00454650-b66c-32f9-ae32-eff038dd1e1d
 	 */
 	@DELETE
 	@Path("/{" + RECORD_ID_PARAMETER + "}")
@@ -256,7 +275,9 @@ public class TraceabilityUnitRESTAPIs extends BaseRESTAPIs<TraceabilityUnitRecor
 	}
 	
 	/**
-	 * @pathExample /traceability-unit/004d6fd2-3e49-4246-b321-f768efdaa7b6
+	 * This API allows to purge a traceability unit record.
+	 * The record cannot be restored.
+	 * @pathExample /traceability-unit/00454650-b66c-32f9-ae32-eff038dd1e1d
 	 */
 	@PURGE
 	@Path("/{" + RECORD_ID_PARAMETER + "}")
diff --git a/src/main/resources/api-docs-examples/fishery/create-fishery-request.json b/src/main/resources/api-docs-examples/fishery/create-fishery-request.json
new file mode 100644
index 0000000..e368831
--- /dev/null
+++ b/src/main/resources/api-docs-examples/fishery/create-fishery-request.json
@@ -0,0 +1,29 @@
+{
+  "fishery_name" : "Carcharhinus borneensis - Myanmar National Jurisdiction Area - Department of Fisheries, Myanmar - Myanmar - Hooks and lines",
+  "license_id" : "CC-BY-SA-4.0",
+  "version" : 1.0,
+  "status_grsf_record" : "pending",
+  "database_sources" : [ "Fisheries and Resources Monitoring System (FIRMS)" ],
+  "fishery_uri" : "https://github.com/grsf/resource/grsf/fishery/d0145931-58d3-4561-bf64-363b61df016b",
+  "grsf_uuid" : "d0145931-58d3-4561-bf64-363b61df016b",
+  "grsf_type" : "fishing unit",
+  "source" : "grsf",
+  "traceability_flag" : true,
+  "sdg_flag" : false,
+  "grsf_semantic_identifier" : "asfis:CCX+eez:MMR+authority:NAT:MMR+iso3:MMR+isscfg:09",
+  "refers_to" : [ {
+    "name" : "Fisheries and Resources Monitoring System (FIRMS)",
+    "url" : "https://data.d4science.org/ctlg/GRSF_Admin/8a99697b-5ebe-3a61-ae60-2d5899d201a4"
+  } ],
+  "short_name" : "Shark Fisheries",
+  "species" : [ "Code: CCX, Classification System: ASFIS, Scientific Name: Carcharhinus borneensis" ],
+  "fishing_area" : [ "Code: MMR, System: eez, Name: Myanmar National Jurisdiction Area" ],
+  "hidden_fishing_area" : [ "Code: 57, System: fao, Name: Indian Ocean, Eastern", "Code: MMR, System: eez, Name: Myanmar National Jurisdiction Area" ],
+  "management_body_authorities" : [ "Code: authority:NAT:NAT, System: grsf-org, Name: Department of Fisheries, Myanmar" ],
+  "flag_state" : [ "Code: MMR, System: iso3, Name: Myanmar" ],
+  "fishing_gear" : [ "Code: 09, System: isscfg, Name: Hooks and lines" ],
+  "similarities_indicator" : "without similar records",
+  "connections_indicator" : "not connected",
+  "description" : "Shark Fisheries",
+  "citation" : "© D4Science.org. Carcharhinus borneensis - Myanmar National Jurisdiction Area - Department of Fisheries, Myanmar - Myanmar - Hooks and lines. In: Global Record of Stocks and Fisheries (GRSF). Consiglio Nazionale delle Ricerche, CNR. Version: 1.0. Updated: April 03, 2024. Accessed: [Date accessed and/or downloaded]. http://data.d4science.org/ctlg/GRSF_Admin/d0145931-58d3-4561-bf64-363b61df016b. Database sources: [FIRMS]"
+}
\ No newline at end of file
diff --git a/src/main/resources/api-docs-examples/fishery/create-fishery-response.json b/src/main/resources/api-docs-examples/fishery/create-fishery-response.json
new file mode 100644
index 0000000..67d5c15
--- /dev/null
+++ b/src/main/resources/api-docs-examples/fishery/create-fishery-response.json
@@ -0,0 +1,240 @@
+{
+    "rating": 0.0,
+    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+    "maintainer": "GRSF Publisher",
+    "relationships_as_object": [],
+    "private": true,
+    "maintainer_email": "grsf_publisher@d4science.org",
+    "num_tags": 8,
+    "id": "73b58941-586b-4cbd-ac72-fce087ffd67d",
+    "metadata_created": "2024-04-10T13:55:29.381604",
+    "metadata_modified": "2024-04-10T13:55:29.381612",
+    "author": "GRSF Publisher",
+    "author_email": "grsf_publisher@d4science.org",
+    "state": "active",
+    "version": "1.0",
+    "creator_user_id": "8c77d7d6-17e1-4f72-be95-640bc42e5c80",
+    "type": "dataset",
+    "resources": [
+        {
+            "mimetype": null,
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Fisheries and Resources Monitoring System (FIRMS)",
+            "format": "",
+            "url": "https://data.d4science.org/ctlg/GRSF_Admin/8a99697b-5ebe-3a61-ae60-2d5899d201a4",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "73b58941-586b-4cbd-ac72-fce087ffd67d",
+            "created": "2024-04-10T13:55:29.386319",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 0,
+            "revision_id": "4d074e09-b75d-4a38-bbbb-26ee7a256db4",
+            "url_type": null,
+            "id": "0fd2bb8d-f785-4bfc-8d0e-4334dabccb98",
+            "resource_type": null,
+            "size": null
+        }
+    ],
+    "num_resources": 1,
+    "tags": [
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code 09 System isscfg Name Hooks and lines",
+            "id": "58f109d4-c5b5-4584-add4-18ca5f7623f5",
+            "name": "Code 09 System isscfg Name Hooks and lines"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code 57 System fao Name Indian Ocean Eastern",
+            "id": "13f390c8-54ed-432b-982b-74d134f825ae",
+            "name": "Code 57 System fao Name Indian Ocean Eastern"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code CCX Classification System ASFIS Scientific Name Carcharhinus borneensis",
+            "id": "a116b1f9-b63f-4c68-9733-5374de1acfd3",
+            "name": "Code CCX Classification System ASFIS Scientific Name Carcharhinus borneensis"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code MMR System eez Name Myanmar National Jurisdiction Area",
+            "id": "ba087f2e-ade3-444f-8f0e-c71d02e649ce",
+            "name": "Code MMR System eez Name Myanmar National Jurisdiction Area"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code MMR System iso3 Name Myanmar",
+            "id": "75a5ea08-ab2e-486f-ab08-4439eaaf9947",
+            "name": "Code MMR System iso3 Name Myanmar"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Fishing Unit",
+            "id": "c9e358f7-f924-45fa-9e95-4311f5078b43",
+            "name": "Fishing Unit"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "not connected",
+            "id": "c005d8a7-7c7a-4980-a950-638bd9af8c4d",
+            "name": "not connected"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "without similar records",
+            "id": "26306fb4-c0db-4ac1-8604-94c92c41a1ac",
+            "name": "without similar records"
+        }
+    ],
+    "groups": [
+        {
+            "display_name": "FIRMS",
+            "description": "",
+            "image_display_url": "",
+            "title": "FIRMS",
+            "id": "f10261d3-6203-47aa-9e20-177bc96e8fb4",
+            "name": "firms-group"
+        },
+        {
+            "display_name": "Fishery",
+            "description": "",
+            "image_display_url": "",
+            "title": "Fishery",
+            "id": "6d66319c-3232-46f2-80c7-d1323ac46299",
+            "name": "fishery-group"
+        },
+        {
+            "display_name": "GRSF",
+            "description": "",
+            "image_display_url": "",
+            "title": "GRSF",
+            "id": "016d24fc-51b2-4f61-a58d-f37e96022891",
+            "name": "grsf-group"
+        },
+        {
+            "display_name": "GRSF Traceability Flag",
+            "description": "",
+            "image_display_url": "",
+            "title": "GRSF Traceability Flag",
+            "id": "4ab2f165-6a8f-467d-b318-f716d1d0088a",
+            "name": "grsf-traceability-flag-group"
+        }
+    ],
+    "license_id": "CC-BY-SA-4.0",
+    "relationships_as_subject": [],
+    "organization": {
+        "description": "Global Record of Stocks and Fisheries (GRSF)",
+        "created": "2024-03-18T14:57:25.062819",
+        "title": "GRSF",
+        "name": "grsf",
+        "is_organization": true,
+        "state": "active",
+        "image_url": "",
+        "revision_id": "1f2048ab-97ec-4502-8bdb-1dc0136489e4",
+        "type": "organization",
+        "id": "8c3f99db-fd09-4341-b060-87a7c902bc5d",
+        "approval_status": "approved"
+    },
+    "name": "d0145931-58d3-4561-bf64-363b61df016b",
+    "isopen": true,
+    "url": null,
+    "notes": "Short Name: Shark Fisheries\nGRSF Semantic Identifier: asfis:CCX+eez:MMR+authority:NAT:MMR+iso3:MMR+isscfg:09\nRecord URL: https://data-pre.d4science.org/ctlg/GRSF_Pre/d0145931-58d3-4561-bf64-363b61df016b",
+    "extras": [
+        {
+            "key": "Citation",
+            "value": "© D4Science.org. Carcharhinus borneensis - Myanmar National Jurisdiction Area - Department of Fisheries, Myanmar - Myanmar - Hooks and lines. In: Global Record of Stocks and Fisheries (GRSF). Consiglio Nazionale delle Ricerche, CNR. Version: 1.0. Updated: April 03, 2024. Accessed: [Date accessed and/or downloaded]. http://data.d4science.org/ctlg/GRSF_Admin/d0145931-58d3-4561-bf64-363b61df016b. Database sources: [FIRMS]"
+        },
+        {
+            "key": "Domain",
+            "value": "Fishery"
+        },
+        {
+            "key": "GRSF UUID",
+            "value": "d0145931-58d3-4561-bf64-363b61df016b"
+        },
+        {
+            "key": "Record URL",
+            "value": "https://data-pre.d4science.org/ctlg/GRSF_Pre/d0145931-58d3-4561-bf64-363b61df016b"
+        },
+        {
+            "key": "SDG Flag",
+            "value": "false"
+        },
+        {
+            "key": "Status of the Record",
+            "value": "pending"
+        },
+        {
+            "key": "Traceability Flag",
+            "value": "true"
+        },
+        {
+            "key": "fishery_identity:Database Source",
+            "value": "Fisheries and Resources Monitoring System (FIRMS)"
+        },
+        {
+            "key": "fishery_identity:Fishing Area",
+            "value": "Code: MMR, System: eez, Name: Myanmar National Jurisdiction Area"
+        },
+        {
+            "key": "fishery_identity:Fishing Gear",
+            "value": "Code: 09, System: isscfg, Name: Hooks and lines"
+        },
+        {
+            "key": "fishery_identity:Flag State",
+            "value": "Code: MMR, System: iso3, Name: Myanmar"
+        },
+        {
+            "key": "fishery_identity:GRSF Fishery Name",
+            "value": "Carcharhinus borneensis - Myanmar National Jurisdiction Area - Department of Fisheries, Myanmar - Myanmar - Hooks and lines"
+        },
+        {
+            "key": "fishery_identity:GRSF Semantic Identifier",
+            "value": "asfis:CCX+eez:MMR+authority:NAT:MMR+iso3:MMR+isscfg:09"
+        },
+        {
+            "key": "fishery_identity:GRSF Type",
+            "value": "Fishing Unit"
+        },
+        {
+            "key": "fishery_identity:Intersecting FAO Major Fishing Areas",
+            "value": "Code: MMR, System: eez, Name: Myanmar National Jurisdiction Area"
+        },
+        {
+            "key": "fishery_identity:Intersecting FAO Major Fishing Areas",
+            "value": "Code: 57, System: fao, Name: Indian Ocean, Eastern"
+        },
+        {
+            "key": "fishery_identity:Management Body/Authority",
+            "value": "Code: authority:NAT:NAT, System: grsf-org, Name: Department of Fisheries, Myanmar"
+        },
+        {
+            "key": "fishery_identity:Short Name",
+            "value": "Shark Fisheries"
+        },
+        {
+            "key": "fishery_identity:Species",
+            "value": "Code: CCX, Classification System: ASFIS, Scientific Name: Carcharhinus borneensis"
+        },
+        {
+            "key": "system:type",
+            "value": "Fishing Unit"
+        }
+    ],
+    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+    "ratings_count": 0,
+    "title": "Carcharhinus borneensis - Myanmar National Jurisdiction Area - Department of Fisheries, Myanmar - Myanmar - Hooks and lines",
+    "revision_id": "4d074e09-b75d-4a38-bbbb-26ee7a256db4"
+}
\ No newline at end of file
diff --git a/src/main/resources/api-docs-examples/fishery/read-fishery-response.json b/src/main/resources/api-docs-examples/fishery/read-fishery-response.json
new file mode 100644
index 0000000..67d5c15
--- /dev/null
+++ b/src/main/resources/api-docs-examples/fishery/read-fishery-response.json
@@ -0,0 +1,240 @@
+{
+    "rating": 0.0,
+    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+    "maintainer": "GRSF Publisher",
+    "relationships_as_object": [],
+    "private": true,
+    "maintainer_email": "grsf_publisher@d4science.org",
+    "num_tags": 8,
+    "id": "73b58941-586b-4cbd-ac72-fce087ffd67d",
+    "metadata_created": "2024-04-10T13:55:29.381604",
+    "metadata_modified": "2024-04-10T13:55:29.381612",
+    "author": "GRSF Publisher",
+    "author_email": "grsf_publisher@d4science.org",
+    "state": "active",
+    "version": "1.0",
+    "creator_user_id": "8c77d7d6-17e1-4f72-be95-640bc42e5c80",
+    "type": "dataset",
+    "resources": [
+        {
+            "mimetype": null,
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Fisheries and Resources Monitoring System (FIRMS)",
+            "format": "",
+            "url": "https://data.d4science.org/ctlg/GRSF_Admin/8a99697b-5ebe-3a61-ae60-2d5899d201a4",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "73b58941-586b-4cbd-ac72-fce087ffd67d",
+            "created": "2024-04-10T13:55:29.386319",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 0,
+            "revision_id": "4d074e09-b75d-4a38-bbbb-26ee7a256db4",
+            "url_type": null,
+            "id": "0fd2bb8d-f785-4bfc-8d0e-4334dabccb98",
+            "resource_type": null,
+            "size": null
+        }
+    ],
+    "num_resources": 1,
+    "tags": [
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code 09 System isscfg Name Hooks and lines",
+            "id": "58f109d4-c5b5-4584-add4-18ca5f7623f5",
+            "name": "Code 09 System isscfg Name Hooks and lines"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code 57 System fao Name Indian Ocean Eastern",
+            "id": "13f390c8-54ed-432b-982b-74d134f825ae",
+            "name": "Code 57 System fao Name Indian Ocean Eastern"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code CCX Classification System ASFIS Scientific Name Carcharhinus borneensis",
+            "id": "a116b1f9-b63f-4c68-9733-5374de1acfd3",
+            "name": "Code CCX Classification System ASFIS Scientific Name Carcharhinus borneensis"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code MMR System eez Name Myanmar National Jurisdiction Area",
+            "id": "ba087f2e-ade3-444f-8f0e-c71d02e649ce",
+            "name": "Code MMR System eez Name Myanmar National Jurisdiction Area"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code MMR System iso3 Name Myanmar",
+            "id": "75a5ea08-ab2e-486f-ab08-4439eaaf9947",
+            "name": "Code MMR System iso3 Name Myanmar"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Fishing Unit",
+            "id": "c9e358f7-f924-45fa-9e95-4311f5078b43",
+            "name": "Fishing Unit"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "not connected",
+            "id": "c005d8a7-7c7a-4980-a950-638bd9af8c4d",
+            "name": "not connected"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "without similar records",
+            "id": "26306fb4-c0db-4ac1-8604-94c92c41a1ac",
+            "name": "without similar records"
+        }
+    ],
+    "groups": [
+        {
+            "display_name": "FIRMS",
+            "description": "",
+            "image_display_url": "",
+            "title": "FIRMS",
+            "id": "f10261d3-6203-47aa-9e20-177bc96e8fb4",
+            "name": "firms-group"
+        },
+        {
+            "display_name": "Fishery",
+            "description": "",
+            "image_display_url": "",
+            "title": "Fishery",
+            "id": "6d66319c-3232-46f2-80c7-d1323ac46299",
+            "name": "fishery-group"
+        },
+        {
+            "display_name": "GRSF",
+            "description": "",
+            "image_display_url": "",
+            "title": "GRSF",
+            "id": "016d24fc-51b2-4f61-a58d-f37e96022891",
+            "name": "grsf-group"
+        },
+        {
+            "display_name": "GRSF Traceability Flag",
+            "description": "",
+            "image_display_url": "",
+            "title": "GRSF Traceability Flag",
+            "id": "4ab2f165-6a8f-467d-b318-f716d1d0088a",
+            "name": "grsf-traceability-flag-group"
+        }
+    ],
+    "license_id": "CC-BY-SA-4.0",
+    "relationships_as_subject": [],
+    "organization": {
+        "description": "Global Record of Stocks and Fisheries (GRSF)",
+        "created": "2024-03-18T14:57:25.062819",
+        "title": "GRSF",
+        "name": "grsf",
+        "is_organization": true,
+        "state": "active",
+        "image_url": "",
+        "revision_id": "1f2048ab-97ec-4502-8bdb-1dc0136489e4",
+        "type": "organization",
+        "id": "8c3f99db-fd09-4341-b060-87a7c902bc5d",
+        "approval_status": "approved"
+    },
+    "name": "d0145931-58d3-4561-bf64-363b61df016b",
+    "isopen": true,
+    "url": null,
+    "notes": "Short Name: Shark Fisheries\nGRSF Semantic Identifier: asfis:CCX+eez:MMR+authority:NAT:MMR+iso3:MMR+isscfg:09\nRecord URL: https://data-pre.d4science.org/ctlg/GRSF_Pre/d0145931-58d3-4561-bf64-363b61df016b",
+    "extras": [
+        {
+            "key": "Citation",
+            "value": "© D4Science.org. Carcharhinus borneensis - Myanmar National Jurisdiction Area - Department of Fisheries, Myanmar - Myanmar - Hooks and lines. In: Global Record of Stocks and Fisheries (GRSF). Consiglio Nazionale delle Ricerche, CNR. Version: 1.0. Updated: April 03, 2024. Accessed: [Date accessed and/or downloaded]. http://data.d4science.org/ctlg/GRSF_Admin/d0145931-58d3-4561-bf64-363b61df016b. Database sources: [FIRMS]"
+        },
+        {
+            "key": "Domain",
+            "value": "Fishery"
+        },
+        {
+            "key": "GRSF UUID",
+            "value": "d0145931-58d3-4561-bf64-363b61df016b"
+        },
+        {
+            "key": "Record URL",
+            "value": "https://data-pre.d4science.org/ctlg/GRSF_Pre/d0145931-58d3-4561-bf64-363b61df016b"
+        },
+        {
+            "key": "SDG Flag",
+            "value": "false"
+        },
+        {
+            "key": "Status of the Record",
+            "value": "pending"
+        },
+        {
+            "key": "Traceability Flag",
+            "value": "true"
+        },
+        {
+            "key": "fishery_identity:Database Source",
+            "value": "Fisheries and Resources Monitoring System (FIRMS)"
+        },
+        {
+            "key": "fishery_identity:Fishing Area",
+            "value": "Code: MMR, System: eez, Name: Myanmar National Jurisdiction Area"
+        },
+        {
+            "key": "fishery_identity:Fishing Gear",
+            "value": "Code: 09, System: isscfg, Name: Hooks and lines"
+        },
+        {
+            "key": "fishery_identity:Flag State",
+            "value": "Code: MMR, System: iso3, Name: Myanmar"
+        },
+        {
+            "key": "fishery_identity:GRSF Fishery Name",
+            "value": "Carcharhinus borneensis - Myanmar National Jurisdiction Area - Department of Fisheries, Myanmar - Myanmar - Hooks and lines"
+        },
+        {
+            "key": "fishery_identity:GRSF Semantic Identifier",
+            "value": "asfis:CCX+eez:MMR+authority:NAT:MMR+iso3:MMR+isscfg:09"
+        },
+        {
+            "key": "fishery_identity:GRSF Type",
+            "value": "Fishing Unit"
+        },
+        {
+            "key": "fishery_identity:Intersecting FAO Major Fishing Areas",
+            "value": "Code: MMR, System: eez, Name: Myanmar National Jurisdiction Area"
+        },
+        {
+            "key": "fishery_identity:Intersecting FAO Major Fishing Areas",
+            "value": "Code: 57, System: fao, Name: Indian Ocean, Eastern"
+        },
+        {
+            "key": "fishery_identity:Management Body/Authority",
+            "value": "Code: authority:NAT:NAT, System: grsf-org, Name: Department of Fisheries, Myanmar"
+        },
+        {
+            "key": "fishery_identity:Short Name",
+            "value": "Shark Fisheries"
+        },
+        {
+            "key": "fishery_identity:Species",
+            "value": "Code: CCX, Classification System: ASFIS, Scientific Name: Carcharhinus borneensis"
+        },
+        {
+            "key": "system:type",
+            "value": "Fishing Unit"
+        }
+    ],
+    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+    "ratings_count": 0,
+    "title": "Carcharhinus borneensis - Myanmar National Jurisdiction Area - Department of Fisheries, Myanmar - Myanmar - Hooks and lines",
+    "revision_id": "4d074e09-b75d-4a38-bbbb-26ee7a256db4"
+}
\ No newline at end of file
diff --git a/src/main/resources/api-docs-examples/stock/create-stock-request.json b/src/main/resources/api-docs-examples/stock/create-stock-request.json
new file mode 100644
index 0000000..eb2954b
--- /dev/null
+++ b/src/main/resources/api-docs-examples/stock/create-stock-request.json
@@ -0,0 +1,104 @@
+{
+  "stock_name" : "Pagellus erythrinus - Levant",
+  "license_id" : "CC-BY-SA-4.0",
+  "version" : 1.0,
+  "status_grsf_record" : "approved",
+  "database_sources" : [ "Fisheries and Resources Monitoring System (FIRMS)" ],
+  "stock_uri" : "https://github.com/grsf/resource/grsf/stock/23fd6734-b7cd-37eb-8b43-03b1495dd7af",
+  "grsf_uuid" : "23fd6734-b7cd-37eb-8b43-03b1495dd7af",
+  "short_name" : "Common pandora - Eastern Levant Sea",
+  "description" : "Common pandora - Eastern Levant Sea",
+  "grsf_type" : "assessment unit",
+  "source" : "grsf",
+  "sdg_flag" : false,
+  "refers_to" : [ {
+    "name" : "Fisheries and Resources Monitoring System (FIRMS)",
+    "url" : "https://data.d4science.org/ctlg/GRSF_Admin/dacc57f6-627b-3c07-b9ad-ddcb72f8af12"
+  } ],
+  "species" : [ "Code: PAC, Classification System: ASFIS, Scientific Name: Pagellus erythrinus" ],
+  "assessment_area" : [ "Code: 27, System: gfcm, Name: Levant" ],
+  "hidden_assessment_area" : [ "Code: 37, System: fao, Name: Mediterranean and Black Sea" ],
+  "scientific_advice" : [ {
+    "value" : "Reduce fishing mortality. [Data Owner: General Fisheries Commission for the Mediterranean (GFCM), DB Source: FIRMS]",
+    "reference_year" : "2021"
+  } ],
+  "state_and_trend_of_marine_resources" : [ {
+    "value" : "In overexploitation. [The GFCM methodology to provide stock status and management advice is described in the Appendix F of the Sixteenth Session of the Scientific Advisory Committee Report. See the Bibliography section.] [Data Owner: General Fisheries Commission for the Mediterranean (GFCM), DB Source: FIRMS]",
+    "reference_year" : 2019
+  } ],
+  "fao_categories" : [ {
+    "source" : "FIRMS",
+    "value" : "overfished",
+    "reference_year" : 2019
+  } ],
+  "data_owner" : [ "General Fisheries Commission for the Mediterranean (GFCM) [DB Source: [FIRMS]]" ],
+  "assessment_methods" : [ {
+    "value" : "VIT in addition to LBSPR and LIME",
+    "reference_year" : 2019,
+    "db_source" : "FIRMS",
+    "reporting_year_or_assessment_id" : "2021",
+    "data_owner" : "General Fisheries Commission for the Mediterranean (GFCM)"
+  } ],
+  "connections_indicator" : "not connected",
+  "grsf_semantic_identifier" : "asfis:PAC+gfcm:27",
+  "similarities_indicator" : "without similar records",
+  "firms_standard_abundance_level" : [ {
+    "value" : "not applicable",
+    "reference_year" : 2019,
+    "db_source" : "FIRMS",
+    "reporting_year_or_assessment_id" : "2021",
+    "data_owner" : "General Fisheries Commission for the Mediterranean (GFCM)"
+  } ],
+  "firms_standard_fishing_pressure" : [ {
+    "value" : "not applicable",
+    "reference_year" : 2019,
+    "db_source" : "FIRMS",
+    "reporting_year_or_assessment_id" : "2021",
+    "data_owner" : "General Fisheries Commission for the Mediterranean (GFCM)"
+  } ],
+  "fishing_pressure" : [ {
+    "value" : "In overexploitation (F/Fref = 1.9)",
+    "reference_year" : 2019,
+    "unit" : "",
+    "db_source" : "FIRMS",
+    "reporting_year_or_assessment_id" : "2021",
+    "data_owner" : "General Fisheries Commission for the Mediterranean (GFCM)"
+  } ],
+  "landings" : [ {
+    "value" : "82.2",
+    "unit" : "tonnes",
+    "reference_year" : 2019,
+    "db_source" : "FIRMS",
+    "reporting_year_or_assessment_id" : "2021",
+    "data_owner" : "General Fisheries Commission for the Mediterranean (GFCM)"
+  }, {
+    "value" : "134.8",
+    "unit" : "tonnes",
+    "reference_year" : 2018,
+    "db_source" : "FIRMS",
+    "reporting_year_or_assessment_id" : "2021",
+    "data_owner" : "General Fisheries Commission for the Mediterranean (GFCM)"
+  }, {
+    "value" : "-",
+    "unit" : "tonnes",
+    "reference_year" : 2017,
+    "db_source" : "FIRMS",
+    "reporting_year_or_assessment_id" : "2021",
+    "data_owner" : "General Fisheries Commission for the Mediterranean (GFCM)"
+  }, {
+    "value" : "104",
+    "unit" : "tonnes",
+    "reference_year" : 2016,
+    "db_source" : "FIRMS",
+    "reporting_year_or_assessment_id" : "2021",
+    "data_owner" : "General Fisheries Commission for the Mediterranean (GFCM)"
+  }, {
+    "value" : "151",
+    "unit" : "tonnes",
+    "reference_year" : 2015,
+    "db_source" : "FIRMS",
+    "reporting_year_or_assessment_id" : "2021",
+    "data_owner" : "General Fisheries Commission for the Mediterranean (GFCM)"
+  } ],
+  "citation" : "© D4Science.org. Pagellus erythrinus - Levant. In: Global Record of Stocks and Fisheries (GRSF). Consiglio Nazionale delle Ricerche, CNR. Version: 1.0. Updated: April 03, 2024. Accessed: [Date accessed and/or downloaded]. http://data.d4science.org/ctlg/GRSF_Admin/23fd6734-b7cd-37eb-8b43-03b1495dd7af. Database sources: [FIRMS]"
+}
\ No newline at end of file
diff --git a/src/main/resources/api-docs-examples/stock/create-stock-response.json b/src/main/resources/api-docs-examples/stock/create-stock-response.json
new file mode 100644
index 0000000..852846f
--- /dev/null
+++ b/src/main/resources/api-docs-examples/stock/create-stock-response.json
@@ -0,0 +1,490 @@
+{
+    "rating": 0.0,
+    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+    "maintainer": "GRSF Publisher",
+    "relationships_as_object": [],
+    "private": true,
+    "maintainer_email": "grsf_publisher@d4science.org",
+    "num_tags": 6,
+    "id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+    "metadata_created": "2024-04-10T14:25:32.177047",
+    "metadata_modified": "2024-04-10T14:25:32.177056",
+    "author": "GRSF Publisher",
+    "author_email": "grsf_publisher@d4science.org",
+    "state": "active",
+    "version": "1.0",
+    "creator_user_id": "8c77d7d6-17e1-4f72-be95-640bc42e5c80",
+    "type": "dataset",
+    "resources": [
+        {
+            "mimetype": null,
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Fisheries and Resources Monitoring System (FIRMS)",
+            "format": "",
+            "url": "https://data.d4science.org/ctlg/GRSF_Admin/dacc57f6-627b-3c07-b9ad-ddcb72f8af12",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183647",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 0,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "9a4077a3-85b4-47ae-becf-93c8048667af",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Landing",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_YmdxQ0IrdHBZUEUweGFyWmh3ZmJhQ1hlb0NQQm92Vk51d3JmQStqWWkrZWgrS1JEQ25lN293TVQ0NVhOaTREaA==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183654",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 1,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "8838aae2-e103-4f79-abfb-e07cc870a837",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Assessment Method",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_cjNhUEJSbk9hSEFFSWZoTjFJS3JqQzJhMzRteGFNcjR1ZFZ2eEJuN2Rhd1VzTXdSOG1JTGJFeUt4RkNKQW0zeg==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183658",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 2,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "babf868e-cbe9-4ef0-aea2-c254e8db4690",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Abundance Level (FIRMS Standard)",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_ME5UclhYbWxxS09ncXpOS2I4YTExSU16NlR3L3dNSU11N2xmL3Rsa0RzVk5hNVZLdnlSbnlOenJQMjluazc3Uw==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183661",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 3,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "b8b2ba00-7bb5-4e28-8ec8-345955901125",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Fishing Pressure (FIRMS Standard)",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_UmxadDNpR251RXo2c1ViaFozTzJEUkhqaE50Z3V3VmRkNUlQS25xbHZ3R3k5NUtJUEFPQ0R1RW9OR29UVjd6Vw==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183665",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 4,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "a08c93f4-bf8f-40dc-b337-a44df2858831",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Fishing Pressure",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_cFFJRURQRXJKUmNLbmJxaWQyMDc3NjE0U3ZuQnFwR1JsdlhrTGpEODVaQzEwTWdYcjdzbHlGWmZvZFA2eTBVUg==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183675",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 5,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "eec732d7-bb33-4e1b-9559-a0a938cbd178",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "State and Trend",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_VlZPaURGTmJ5SGhNMkZNOC8xL2RjbXRjMjlNR2ZsUy9zWGxpdUVEaTNtcTdUS29ON2NnS3F6ekJ5SERWSkl5Nw==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183678",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 6,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "0980f9d7-f941-4507-9eff-be3d70ac431b",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "FAO Stock Status Category",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_bmtFc0tsOGlOYUp2MWoxK09CampvcUZGbFR6Ny9WT2s3bEM1d3ZEOFkybDE0Ykk0MmxVWlVuK3BkbUR1R0ZaRQ==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183682",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 7,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "6c479c53-9486-4418-8cc4-ee3796fe49a7",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Scientific Advice",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_RFhPeGx6aWp1MkVGM01VNUVVa3Z1NE5kR1hVS3NuNXgveGtmbW5EbnAxMXlsUE1hU1BMcU1FK0RVSkRHNVNMRg==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183685",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 8,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "cab198dc-7564-4f39-ba83-202ca2750d59",
+            "resource_type": null,
+            "size": null
+        }
+    ],
+    "num_resources": 9,
+    "tags": [
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Assessment Unit",
+            "id": "342528f9-ad20-4bfe-be64-ff1d91ea3d1d",
+            "name": "Assessment Unit"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code 27 System gfcm Name Levant",
+            "id": "1ddf0973-ba66-4c92-b62d-28719e790498",
+            "name": "Code 27 System gfcm Name Levant"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code 37 System fao Name Mediterranean and Black Sea",
+            "id": "b874ef2d-da3d-4030-8198-ad2676f6830b",
+            "name": "Code 37 System fao Name Mediterranean and Black Sea"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code PAC Classification System ASFIS Scientific Name Pagellus erythrinus",
+            "id": "abfa76ea-5fc4-449d-941c-04c6e4390823",
+            "name": "Code PAC Classification System ASFIS Scientific Name Pagellus erythrinus"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "not connected",
+            "id": "c005d8a7-7c7a-4980-a950-638bd9af8c4d",
+            "name": "not connected"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "without similar records",
+            "id": "26306fb4-c0db-4ac1-8604-94c92c41a1ac",
+            "name": "without similar records"
+        }
+    ],
+    "groups": [
+        {
+            "display_name": "Abundance Level (FIRMS Standard)",
+            "description": "",
+            "image_display_url": "",
+            "title": "Abundance Level (FIRMS Standard)",
+            "id": "17a83228-eafe-4db2-a9d9-d3f5d66669a8",
+            "name": "abundance-level-firms-standard-group"
+        },
+        {
+            "display_name": "Assessment Method",
+            "description": "",
+            "image_display_url": "",
+            "title": "Assessment Method",
+            "id": "2d74bf27-55eb-4ba5-ae0e-46513829dbcb",
+            "name": "assessment-method-group"
+        },
+        {
+            "display_name": "FAO Stock Status Category",
+            "description": "",
+            "image_display_url": "",
+            "title": "FAO Stock Status Category",
+            "id": "134b2aff-e139-4c3a-b0b9-9664740b5c1f",
+            "name": "fao-stock-status-category-group"
+        },
+        {
+            "display_name": "FIRMS",
+            "description": "",
+            "image_display_url": "",
+            "title": "FIRMS",
+            "id": "f10261d3-6203-47aa-9e20-177bc96e8fb4",
+            "name": "firms-group"
+        },
+        {
+            "display_name": "Fishing Pressure",
+            "description": "",
+            "image_display_url": "",
+            "title": "Fishing Pressure",
+            "id": "82646dfa-1815-49e8-8929-2d9caf41ac75",
+            "name": "fishing-pressure-group"
+        },
+        {
+            "display_name": "Fishing Pressure (FIRMS Standard)",
+            "description": "",
+            "image_display_url": "",
+            "title": "Fishing Pressure (FIRMS Standard)",
+            "id": "a54afc4e-1a8e-4bc5-8f8c-0032b7b71f88",
+            "name": "fishing-pressure-firms-standard-group"
+        },
+        {
+            "display_name": "GRSF",
+            "description": "",
+            "image_display_url": "",
+            "title": "GRSF",
+            "id": "016d24fc-51b2-4f61-a58d-f37e96022891",
+            "name": "grsf-group"
+        },
+        {
+            "display_name": "Landing",
+            "description": "",
+            "image_display_url": "",
+            "title": "Landing",
+            "id": "263b2af8-e27e-4661-8929-ead5e3884180",
+            "name": "landing-group"
+        },
+        {
+            "display_name": "Scientific Advice",
+            "description": "",
+            "image_display_url": "",
+            "title": "Scientific Advice",
+            "id": "92cb42f8-3235-467e-8331-6c7c53108ba1",
+            "name": "scientific-advice-group"
+        },
+        {
+            "display_name": "State and Trend",
+            "description": "",
+            "image_display_url": "",
+            "title": "State and Trend",
+            "id": "e46123e0-7fc6-4749-af8f-a8c8f8f35296",
+            "name": "state-and-trend-group"
+        },
+        {
+            "display_name": "Stock",
+            "description": "",
+            "image_display_url": "",
+            "title": "Stock",
+            "id": "e4d91953-de56-4a38-81cf-b9e9578385b5",
+            "name": "stock-group"
+        }
+    ],
+    "license_id": "CC-BY-SA-4.0",
+    "relationships_as_subject": [],
+    "organization": {
+        "description": "Global Record of Stocks and Fisheries (GRSF)",
+        "created": "2024-03-18T14:57:25.062819",
+        "title": "GRSF",
+        "name": "grsf",
+        "is_organization": true,
+        "state": "active",
+        "image_url": "",
+        "revision_id": "1f2048ab-97ec-4502-8bdb-1dc0136489e4",
+        "type": "organization",
+        "id": "8c3f99db-fd09-4341-b060-87a7c902bc5d",
+        "approval_status": "approved"
+    },
+    "name": "23fd6734-b7cd-37eb-8b43-03b1495dd7af",
+    "isopen": true,
+    "url": null,
+    "notes": "Short Name: Common pandora - Eastern Levant Sea\nGRSF Semantic Identifier: asfis:PAC+gfcm:27\nRecord URL: https://data-pre.d4science.org/ctlg/GRSF_Pre/23fd6734-b7cd-37eb-8b43-03b1495dd7af",
+    "extras": [
+        {
+            "key": "Citation",
+            "value": "© D4Science.org. Pagellus erythrinus - Levant. In: Global Record of Stocks and Fisheries (GRSF). Consiglio Nazionale delle Ricerche, CNR. Version: 1.0. Updated: April 03, 2024. Accessed: [Date accessed and/or downloaded]. http://data.d4science.org/ctlg/GRSF_Admin/23fd6734-b7cd-37eb-8b43-03b1495dd7af. Database sources: [FIRMS]"
+        },
+        {
+            "key": "Domain",
+            "value": "Stock"
+        },
+        {
+            "key": "GRSF UUID",
+            "value": "23fd6734-b7cd-37eb-8b43-03b1495dd7af"
+        },
+        {
+            "key": "Record URL",
+            "value": "https://data-pre.d4science.org/ctlg/GRSF_Pre/23fd6734-b7cd-37eb-8b43-03b1495dd7af"
+        },
+        {
+            "key": "SDG Flag",
+            "value": "false"
+        },
+        {
+            "key": "Status of the Record",
+            "value": "approved"
+        },
+        {
+            "key": "stock_data:Abundance Level (FIRMS Standard)",
+            "value": "not applicable [Rep. Year or Assessment ID: 2021 - Ref. Year: 2,019 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Assessment Method",
+            "value": "VIT in addition to LBSPR and LIME [Rep. Year or Assessment ID: 2021 - Ref. Year: 2,019 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Data Owner",
+            "value": "General Fisheries Commission for the Mediterranean (GFCM) [DB Source: [FIRMS]]"
+        },
+        {
+            "key": "stock_data:FAO Stock Status Category",
+            "value": "overfished [Ref. Year: 2,019]"
+        },
+        {
+            "key": "stock_data:Fishing Pressure",
+            "value": "In overexploitation (F/Fref = 1.9) [Rep. Year or Assessment ID: 2021 - Ref. Year: 2,019 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Fishing Pressure (FIRMS Standard)",
+            "value": "not applicable [Rep. Year or Assessment ID: 2021 - Ref. Year: 2,019 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Landing",
+            "value": "151 [Unit: tonnes - Rep. Year or Assessment ID: 2021 - Ref. Year: 2,015 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Landing",
+            "value": "104 [Unit: tonnes - Rep. Year or Assessment ID: 2021 - Ref. Year: 2,016 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Landing",
+            "value": "- [Unit: tonnes - Rep. Year or Assessment ID: 2021 - Ref. Year: 2,017 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Landing",
+            "value": "134.8 [Unit: tonnes - Rep. Year or Assessment ID: 2021 - Ref. Year: 2,018 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Landing",
+            "value": "82.2 [Unit: tonnes - Rep. Year or Assessment ID: 2021 - Ref. Year: 2,019 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Scientific Advice",
+            "value": "Reduce fishing mortality. [Data Owner: General Fisheries Commission for the Mediterranean (GFCM), DB Source: FIRMS] [Ref. Year: 2021]"
+        },
+        {
+            "key": "stock_data:State and Trend",
+            "value": "In overexploitation. [The GFCM methodology to provide stock status and management advice is described in the Appendix F of the Sixteenth Session of the Scientific Advisory Committee Report. See the Bibliography section.] [Data Owner: General Fisheries Commission for the Mediterranean (GFCM), DB Source: FIRMS] [Ref. Year: 2,019]"
+        },
+        {
+            "key": "stock_identity:Assessment Area",
+            "value": "Code: 27, System: gfcm, Name: Levant"
+        },
+        {
+            "key": "stock_identity:Database Source",
+            "value": "Fisheries and Resources Monitoring System (FIRMS)"
+        },
+        {
+            "key": "stock_identity:GRSF Semantic Identifier",
+            "value": "asfis:PAC+gfcm:27"
+        },
+        {
+            "key": "stock_identity:GRSF Stock Name",
+            "value": "Pagellus erythrinus - Levant"
+        },
+        {
+            "key": "stock_identity:GRSF Type",
+            "value": "Assessment Unit"
+        },
+        {
+            "key": "stock_identity:Intersecting FAO Major Fishing Areas",
+            "value": "Code: 37, System: fao, Name: Mediterranean and Black Sea"
+        },
+        {
+            "key": "stock_identity:Short Name",
+            "value": "Common pandora - Eastern Levant Sea"
+        },
+        {
+            "key": "stock_identity:Species",
+            "value": "Code: PAC, Classification System: ASFIS, Scientific Name: Pagellus erythrinus"
+        },
+        {
+            "key": "system:type",
+            "value": "Assessment Unit"
+        }
+    ],
+    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+    "ratings_count": 0,
+    "title": "Pagellus erythrinus - Levant",
+    "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd"
+}
\ No newline at end of file
diff --git a/src/main/resources/api-docs-examples/stock/read-stock-response.json b/src/main/resources/api-docs-examples/stock/read-stock-response.json
new file mode 100644
index 0000000..852846f
--- /dev/null
+++ b/src/main/resources/api-docs-examples/stock/read-stock-response.json
@@ -0,0 +1,490 @@
+{
+    "rating": 0.0,
+    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+    "maintainer": "GRSF Publisher",
+    "relationships_as_object": [],
+    "private": true,
+    "maintainer_email": "grsf_publisher@d4science.org",
+    "num_tags": 6,
+    "id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+    "metadata_created": "2024-04-10T14:25:32.177047",
+    "metadata_modified": "2024-04-10T14:25:32.177056",
+    "author": "GRSF Publisher",
+    "author_email": "grsf_publisher@d4science.org",
+    "state": "active",
+    "version": "1.0",
+    "creator_user_id": "8c77d7d6-17e1-4f72-be95-640bc42e5c80",
+    "type": "dataset",
+    "resources": [
+        {
+            "mimetype": null,
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Fisheries and Resources Monitoring System (FIRMS)",
+            "format": "",
+            "url": "https://data.d4science.org/ctlg/GRSF_Admin/dacc57f6-627b-3c07-b9ad-ddcb72f8af12",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183647",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 0,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "9a4077a3-85b4-47ae-becf-93c8048667af",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Landing",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_YmdxQ0IrdHBZUEUweGFyWmh3ZmJhQ1hlb0NQQm92Vk51d3JmQStqWWkrZWgrS1JEQ25lN293TVQ0NVhOaTREaA==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183654",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 1,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "8838aae2-e103-4f79-abfb-e07cc870a837",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Assessment Method",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_cjNhUEJSbk9hSEFFSWZoTjFJS3JqQzJhMzRteGFNcjR1ZFZ2eEJuN2Rhd1VzTXdSOG1JTGJFeUt4RkNKQW0zeg==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183658",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 2,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "babf868e-cbe9-4ef0-aea2-c254e8db4690",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Abundance Level (FIRMS Standard)",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_ME5UclhYbWxxS09ncXpOS2I4YTExSU16NlR3L3dNSU11N2xmL3Rsa0RzVk5hNVZLdnlSbnlOenJQMjluazc3Uw==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183661",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 3,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "b8b2ba00-7bb5-4e28-8ec8-345955901125",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Fishing Pressure (FIRMS Standard)",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_UmxadDNpR251RXo2c1ViaFozTzJEUkhqaE50Z3V3VmRkNUlQS25xbHZ3R3k5NUtJUEFPQ0R1RW9OR29UVjd6Vw==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183665",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 4,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "a08c93f4-bf8f-40dc-b337-a44df2858831",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Fishing Pressure",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_cFFJRURQRXJKUmNLbmJxaWQyMDc3NjE0U3ZuQnFwR1JsdlhrTGpEODVaQzEwTWdYcjdzbHlGWmZvZFA2eTBVUg==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183675",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 5,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "eec732d7-bb33-4e1b-9559-a0a938cbd178",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "State and Trend",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_VlZPaURGTmJ5SGhNMkZNOC8xL2RjbXRjMjlNR2ZsUy9zWGxpdUVEaTNtcTdUS29ON2NnS3F6ekJ5SERWSkl5Nw==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183678",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 6,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "0980f9d7-f941-4507-9eff-be3d70ac431b",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "FAO Stock Status Category",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_bmtFc0tsOGlOYUp2MWoxK09CampvcUZGbFR6Ny9WT2s3bEM1d3ZEOFkybDE0Ykk0MmxVWlVuK3BkbUR1R0ZaRQ==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183682",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 7,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "6c479c53-9486-4418-8cc4-ee3796fe49a7",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": "text/csv",
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Scientific Advice",
+            "format": "CSV",
+            "url": "https://data-pre.d4science.org/shub/E_RFhPeGx6aWp1MkVGM01VNUVVa3Z1NE5kR1hVS3NuNXgveGtmbW5EbnAxMXlsUE1hU1BMcU1FK0RVSkRHNVNMRg==",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "f47496b9-7602-40b0-a74c-b33d3341c5be",
+            "created": "2024-04-10T14:25:32.183685",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 8,
+            "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd",
+            "url_type": null,
+            "id": "cab198dc-7564-4f39-ba83-202ca2750d59",
+            "resource_type": null,
+            "size": null
+        }
+    ],
+    "num_resources": 9,
+    "tags": [
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Assessment Unit",
+            "id": "342528f9-ad20-4bfe-be64-ff1d91ea3d1d",
+            "name": "Assessment Unit"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code 27 System gfcm Name Levant",
+            "id": "1ddf0973-ba66-4c92-b62d-28719e790498",
+            "name": "Code 27 System gfcm Name Levant"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code 37 System fao Name Mediterranean and Black Sea",
+            "id": "b874ef2d-da3d-4030-8198-ad2676f6830b",
+            "name": "Code 37 System fao Name Mediterranean and Black Sea"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code PAC Classification System ASFIS Scientific Name Pagellus erythrinus",
+            "id": "abfa76ea-5fc4-449d-941c-04c6e4390823",
+            "name": "Code PAC Classification System ASFIS Scientific Name Pagellus erythrinus"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "not connected",
+            "id": "c005d8a7-7c7a-4980-a950-638bd9af8c4d",
+            "name": "not connected"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "without similar records",
+            "id": "26306fb4-c0db-4ac1-8604-94c92c41a1ac",
+            "name": "without similar records"
+        }
+    ],
+    "groups": [
+        {
+            "display_name": "Abundance Level (FIRMS Standard)",
+            "description": "",
+            "image_display_url": "",
+            "title": "Abundance Level (FIRMS Standard)",
+            "id": "17a83228-eafe-4db2-a9d9-d3f5d66669a8",
+            "name": "abundance-level-firms-standard-group"
+        },
+        {
+            "display_name": "Assessment Method",
+            "description": "",
+            "image_display_url": "",
+            "title": "Assessment Method",
+            "id": "2d74bf27-55eb-4ba5-ae0e-46513829dbcb",
+            "name": "assessment-method-group"
+        },
+        {
+            "display_name": "FAO Stock Status Category",
+            "description": "",
+            "image_display_url": "",
+            "title": "FAO Stock Status Category",
+            "id": "134b2aff-e139-4c3a-b0b9-9664740b5c1f",
+            "name": "fao-stock-status-category-group"
+        },
+        {
+            "display_name": "FIRMS",
+            "description": "",
+            "image_display_url": "",
+            "title": "FIRMS",
+            "id": "f10261d3-6203-47aa-9e20-177bc96e8fb4",
+            "name": "firms-group"
+        },
+        {
+            "display_name": "Fishing Pressure",
+            "description": "",
+            "image_display_url": "",
+            "title": "Fishing Pressure",
+            "id": "82646dfa-1815-49e8-8929-2d9caf41ac75",
+            "name": "fishing-pressure-group"
+        },
+        {
+            "display_name": "Fishing Pressure (FIRMS Standard)",
+            "description": "",
+            "image_display_url": "",
+            "title": "Fishing Pressure (FIRMS Standard)",
+            "id": "a54afc4e-1a8e-4bc5-8f8c-0032b7b71f88",
+            "name": "fishing-pressure-firms-standard-group"
+        },
+        {
+            "display_name": "GRSF",
+            "description": "",
+            "image_display_url": "",
+            "title": "GRSF",
+            "id": "016d24fc-51b2-4f61-a58d-f37e96022891",
+            "name": "grsf-group"
+        },
+        {
+            "display_name": "Landing",
+            "description": "",
+            "image_display_url": "",
+            "title": "Landing",
+            "id": "263b2af8-e27e-4661-8929-ead5e3884180",
+            "name": "landing-group"
+        },
+        {
+            "display_name": "Scientific Advice",
+            "description": "",
+            "image_display_url": "",
+            "title": "Scientific Advice",
+            "id": "92cb42f8-3235-467e-8331-6c7c53108ba1",
+            "name": "scientific-advice-group"
+        },
+        {
+            "display_name": "State and Trend",
+            "description": "",
+            "image_display_url": "",
+            "title": "State and Trend",
+            "id": "e46123e0-7fc6-4749-af8f-a8c8f8f35296",
+            "name": "state-and-trend-group"
+        },
+        {
+            "display_name": "Stock",
+            "description": "",
+            "image_display_url": "",
+            "title": "Stock",
+            "id": "e4d91953-de56-4a38-81cf-b9e9578385b5",
+            "name": "stock-group"
+        }
+    ],
+    "license_id": "CC-BY-SA-4.0",
+    "relationships_as_subject": [],
+    "organization": {
+        "description": "Global Record of Stocks and Fisheries (GRSF)",
+        "created": "2024-03-18T14:57:25.062819",
+        "title": "GRSF",
+        "name": "grsf",
+        "is_organization": true,
+        "state": "active",
+        "image_url": "",
+        "revision_id": "1f2048ab-97ec-4502-8bdb-1dc0136489e4",
+        "type": "organization",
+        "id": "8c3f99db-fd09-4341-b060-87a7c902bc5d",
+        "approval_status": "approved"
+    },
+    "name": "23fd6734-b7cd-37eb-8b43-03b1495dd7af",
+    "isopen": true,
+    "url": null,
+    "notes": "Short Name: Common pandora - Eastern Levant Sea\nGRSF Semantic Identifier: asfis:PAC+gfcm:27\nRecord URL: https://data-pre.d4science.org/ctlg/GRSF_Pre/23fd6734-b7cd-37eb-8b43-03b1495dd7af",
+    "extras": [
+        {
+            "key": "Citation",
+            "value": "© D4Science.org. Pagellus erythrinus - Levant. In: Global Record of Stocks and Fisheries (GRSF). Consiglio Nazionale delle Ricerche, CNR. Version: 1.0. Updated: April 03, 2024. Accessed: [Date accessed and/or downloaded]. http://data.d4science.org/ctlg/GRSF_Admin/23fd6734-b7cd-37eb-8b43-03b1495dd7af. Database sources: [FIRMS]"
+        },
+        {
+            "key": "Domain",
+            "value": "Stock"
+        },
+        {
+            "key": "GRSF UUID",
+            "value": "23fd6734-b7cd-37eb-8b43-03b1495dd7af"
+        },
+        {
+            "key": "Record URL",
+            "value": "https://data-pre.d4science.org/ctlg/GRSF_Pre/23fd6734-b7cd-37eb-8b43-03b1495dd7af"
+        },
+        {
+            "key": "SDG Flag",
+            "value": "false"
+        },
+        {
+            "key": "Status of the Record",
+            "value": "approved"
+        },
+        {
+            "key": "stock_data:Abundance Level (FIRMS Standard)",
+            "value": "not applicable [Rep. Year or Assessment ID: 2021 - Ref. Year: 2,019 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Assessment Method",
+            "value": "VIT in addition to LBSPR and LIME [Rep. Year or Assessment ID: 2021 - Ref. Year: 2,019 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Data Owner",
+            "value": "General Fisheries Commission for the Mediterranean (GFCM) [DB Source: [FIRMS]]"
+        },
+        {
+            "key": "stock_data:FAO Stock Status Category",
+            "value": "overfished [Ref. Year: 2,019]"
+        },
+        {
+            "key": "stock_data:Fishing Pressure",
+            "value": "In overexploitation (F/Fref = 1.9) [Rep. Year or Assessment ID: 2021 - Ref. Year: 2,019 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Fishing Pressure (FIRMS Standard)",
+            "value": "not applicable [Rep. Year or Assessment ID: 2021 - Ref. Year: 2,019 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Landing",
+            "value": "151 [Unit: tonnes - Rep. Year or Assessment ID: 2021 - Ref. Year: 2,015 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Landing",
+            "value": "104 [Unit: tonnes - Rep. Year or Assessment ID: 2021 - Ref. Year: 2,016 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Landing",
+            "value": "- [Unit: tonnes - Rep. Year or Assessment ID: 2021 - Ref. Year: 2,017 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Landing",
+            "value": "134.8 [Unit: tonnes - Rep. Year or Assessment ID: 2021 - Ref. Year: 2,018 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Landing",
+            "value": "82.2 [Unit: tonnes - Rep. Year or Assessment ID: 2021 - Ref. Year: 2,019 - Data Owner: General Fisheries Commission for the Mediterranean (GFCM) - DB Source: FIRMS]"
+        },
+        {
+            "key": "stock_data:Scientific Advice",
+            "value": "Reduce fishing mortality. [Data Owner: General Fisheries Commission for the Mediterranean (GFCM), DB Source: FIRMS] [Ref. Year: 2021]"
+        },
+        {
+            "key": "stock_data:State and Trend",
+            "value": "In overexploitation. [The GFCM methodology to provide stock status and management advice is described in the Appendix F of the Sixteenth Session of the Scientific Advisory Committee Report. See the Bibliography section.] [Data Owner: General Fisheries Commission for the Mediterranean (GFCM), DB Source: FIRMS] [Ref. Year: 2,019]"
+        },
+        {
+            "key": "stock_identity:Assessment Area",
+            "value": "Code: 27, System: gfcm, Name: Levant"
+        },
+        {
+            "key": "stock_identity:Database Source",
+            "value": "Fisheries and Resources Monitoring System (FIRMS)"
+        },
+        {
+            "key": "stock_identity:GRSF Semantic Identifier",
+            "value": "asfis:PAC+gfcm:27"
+        },
+        {
+            "key": "stock_identity:GRSF Stock Name",
+            "value": "Pagellus erythrinus - Levant"
+        },
+        {
+            "key": "stock_identity:GRSF Type",
+            "value": "Assessment Unit"
+        },
+        {
+            "key": "stock_identity:Intersecting FAO Major Fishing Areas",
+            "value": "Code: 37, System: fao, Name: Mediterranean and Black Sea"
+        },
+        {
+            "key": "stock_identity:Short Name",
+            "value": "Common pandora - Eastern Levant Sea"
+        },
+        {
+            "key": "stock_identity:Species",
+            "value": "Code: PAC, Classification System: ASFIS, Scientific Name: Pagellus erythrinus"
+        },
+        {
+            "key": "system:type",
+            "value": "Assessment Unit"
+        }
+    ],
+    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+    "ratings_count": 0,
+    "title": "Pagellus erythrinus - Levant",
+    "revision_id": "97544a94-a421-4d7d-b5f5-04e9b7a2a6fd"
+}
\ No newline at end of file
diff --git a/src/main/resources/api-docs-examples/traceability-unit/create-traceability-unit-request.json b/src/main/resources/api-docs-examples/traceability-unit/create-traceability-unit-request.json
new file mode 100644
index 0000000..cb253b6
--- /dev/null
+++ b/src/main/resources/api-docs-examples/traceability-unit/create-traceability-unit-request.json
@@ -0,0 +1,26 @@
+{
+  "traceability_unit_name" : "Penaeus stylirostris - Pacific, Eastern Central - Mexican Secretary of Agriculture and Rural Development - Mexico National Commission of Aquaculture and Fisheries - Pacific, Eastern Central - Mexico - Drift gillnets",
+  "license_id" : "CC-BY-SA-4.0",
+  "version" : 1.0,
+  "traceability_record_uri" : "https://github.com/grsf/resource/traceability_unit/00454650-b66c-32f9-ae32-eff038dd1e1d",
+  "database_sources" : [ "FishSource" ],
+  "grsf_uuid" : "00454650-b66c-32f9-ae32-eff038dd1e1d",
+  "grsf_semantic_identifier" : "asfis:PNS+fao:77+authority:NAT:MEX+fao:77+iso3:MEX+isscfg:07.2",
+  "short_name" : "Blue shrimp | Upper Gulf of California | Mexico Pacific artisanal | Mexico | Drift gillnets - Blue shrimp - Upper Gulf of California",
+  "source" : "grsf",
+  "species" : [ "Code: PNS, Classification System: ASFIS, Scientific Name: Penaeus stylirostris" ],
+  "assessment_area" : [ "Code: 77, System: FAO, Name: Pacific, Eastern Central" ],
+  "management_reporting_area" : [ "Code: 77, System: FAO, Name: Pacific, Eastern Central" ],
+  "management_body_authorities" : [ "Code: authority:NAT:MEX, System: GRSF-ORG, Name: Mexican Secretary of Agriculture and Rural Development", "Code: authority:NAT:MEX, System: GRSF-ORG, Name: Mexico National Commission of Aquaculture and Fisheries" ],
+  "flag_state" : [ "Code: MEX, System: ISO3, Name: Mexico" ],
+  "fishing_gear" : [ "Code: 07.2, System: ISSCFG, Name: Drift gillnets" ],
+  "referring_stock_record" : {
+    "semantic_id" : "asfis:PNS+fao:77",
+    "url" : "https://data.d4science.org/ctlg/GRSF_Admin/4d9033c3-caf2-3500-beb8-0f5684d29199"
+  },
+  "referring_fishery_record" : {
+    "semantic_id" : "asfis:PNS+fao:77+authority:NAT:MEX+iso3:MEX+isscfg:07.2",
+    "url" : "https://data.d4science.org/ctlg/GRSF_Admin/66e3df5d-be9f-3661-b27b-282a5da3c820"
+  },
+  "citation" : "© D4Science.org. Penaeus stylirostris - Pacific, Eastern Central - Mexican Secretary of Agriculture and Rural Development - Mexico National Commission of Aquaculture and Fisheries - Pacific, Eastern Central - Mexico - Drift gillnets. In: Global Record of Stocks and Fisheries (GRSF). Consiglio Nazionale delle Ricerche, CNR. Version: 1.0. Updated: April 03, 2024. Accessed: [Date accessed and/or downloaded]. http://data.d4science.org/ctlg/GRSF_Admin/00454650-b66c-32f9-ae32-eff038dd1e1d. Database sources: [FishSource]"
+}
\ No newline at end of file
diff --git a/src/main/resources/api-docs-examples/traceability-unit/create-traceability-unit-response.json b/src/main/resources/api-docs-examples/traceability-unit/create-traceability-unit-response.json
new file mode 100644
index 0000000..f2f85ac
--- /dev/null
+++ b/src/main/resources/api-docs-examples/traceability-unit/create-traceability-unit-response.json
@@ -0,0 +1,251 @@
+{
+    "rating": 0.0,
+    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+    "maintainer": "GRSF Publisher",
+    "relationships_as_object": [],
+    "private": true,
+    "maintainer_email": "grsf_publisher@d4science.org",
+    "num_tags": 5,
+    "id": "7179c93c-ef71-4d10-9778-12248bb8e300",
+    "metadata_created": "2024-04-10T15:40:22.225680",
+    "metadata_modified": "2024-04-10T15:40:22.225688",
+    "author": "GRSF Publisher",
+    "author_email": "grsf_publisher@d4science.org",
+    "state": "active",
+    "version": "1.0",
+    "creator_user_id": "8c77d7d6-17e1-4f72-be95-640bc42e5c80",
+    "type": "dataset",
+    "resources": [
+        {
+            "mimetype": null,
+            "cache_url": null,
+            "hash": "",
+            "description": "asfis:PNS+fao:77",
+            "name": "GRSF Stock",
+            "format": "",
+            "url": "https://data.d4science.org/ctlg/GRSF_Admin/4d9033c3-caf2-3500-beb8-0f5684d29199",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "7179c93c-ef71-4d10-9778-12248bb8e300",
+            "created": "2024-04-10T15:40:22.230543",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 0,
+            "revision_id": "23191a39-36bf-4a36-ad42-0df374624c3e",
+            "url_type": null,
+            "id": "cad1413a-1d45-4c7a-a550-802a00536172",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": null,
+            "cache_url": null,
+            "hash": "",
+            "description": "asfis:PNS+fao:77+authority:NAT:MEX+iso3:MEX+isscfg:07.2",
+            "name": "GRSF Fishery",
+            "format": "",
+            "url": "https://data.d4science.org/ctlg/GRSF_Admin/66e3df5d-be9f-3661-b27b-282a5da3c820",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "7179c93c-ef71-4d10-9778-12248bb8e300",
+            "created": "2024-04-10T15:40:22.230550",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 1,
+            "revision_id": "23191a39-36bf-4a36-ad42-0df374624c3e",
+            "url_type": null,
+            "id": "2b258919-5af6-46a3-9097-4506819226ec",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": null,
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Traceability Unit URI",
+            "format": "",
+            "url": "https://github.com/grsf/resource/traceability_unit/00454650-b66c-32f9-ae32-eff038dd1e1d",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "7179c93c-ef71-4d10-9778-12248bb8e300",
+            "created": "2024-04-10T15:40:22.230554",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 2,
+            "revision_id": "23191a39-36bf-4a36-ad42-0df374624c3e",
+            "url_type": null,
+            "id": "fefaa87d-11b1-43d1-8726-f649e7c92e3d",
+            "resource_type": null,
+            "size": null
+        }
+    ],
+    "num_resources": 3,
+    "tags": [
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code 072 System ISSCFG Name Drift gillnets",
+            "id": "c7f1e884-afdf-47ae-ade6-928d8874c800",
+            "name": "Code 072 System ISSCFG Name Drift gillnets"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code 77 System FAO Name Pacific Eastern Central",
+            "id": "55427764-bbd3-4911-a716-37f2b34fe629",
+            "name": "Code 77 System FAO Name Pacific Eastern Central"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code MEX System ISO3 Name Mexico",
+            "id": "1370b3ae-7471-44a1-9106-204d4ac09296",
+            "name": "Code MEX System ISO3 Name Mexico"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code PNS Classification System ASFIS Scientific Name Penaeus stylirostris",
+            "id": "1bac544c-a6ec-44b4-bf5d-743449bbac67",
+            "name": "Code PNS Classification System ASFIS Scientific Name Penaeus stylirostris"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Traceability Unit",
+            "id": "b12869ca-7fe5-48e0-9fe6-09e957202797",
+            "name": "Traceability Unit"
+        }
+    ],
+    "groups": [
+        {
+            "display_name": "FishSource",
+            "description": "",
+            "image_display_url": "",
+            "title": "FishSource",
+            "id": "42b31b78-24d9-4695-a1e8-76fe836603bc",
+            "name": "fishsource-group"
+        },
+        {
+            "display_name": "GRSF",
+            "description": "",
+            "image_display_url": "",
+            "title": "GRSF",
+            "id": "016d24fc-51b2-4f61-a58d-f37e96022891",
+            "name": "grsf-group"
+        },
+        {
+            "display_name": "Traceability Unit",
+            "description": "",
+            "image_display_url": "",
+            "title": "Traceability Unit",
+            "id": "2a7d503f-d961-4a32-8df0-1299596209bd",
+            "name": "traceability-unit-group"
+        }
+    ],
+    "license_id": "CC-BY-SA-4.0",
+    "relationships_as_subject": [],
+    "organization": {
+        "description": "Global Record of Stocks and Fisheries (GRSF)",
+        "created": "2024-03-18T14:57:25.062819",
+        "title": "GRSF",
+        "name": "grsf",
+        "is_organization": true,
+        "state": "active",
+        "image_url": "",
+        "revision_id": "1f2048ab-97ec-4502-8bdb-1dc0136489e4",
+        "type": "organization",
+        "id": "8c3f99db-fd09-4341-b060-87a7c902bc5d",
+        "approval_status": "approved"
+    },
+    "name": "00454650-b66c-32f9-ae32-eff038dd1e1d",
+    "isopen": true,
+    "url": null,
+    "notes": "Short Name: Blue shrimp | Upper Gulf of California | Mexico Pacific artisanal | Mexico | Drift gillnets - Blue shrimp - Upper Gulf of California\nGRSF Semantic Identifier: asfis:PNS+fao:77+authority:NAT:MEX+fao:77+iso3:MEX+isscfg:07.2\nRecord URL: https://data-pre.d4science.org/ctlg/GRSF_Pre/00454650-b66c-32f9-ae32-eff038dd1e1d",
+    "extras": [
+        {
+            "key": "Citation",
+            "value": "© D4Science.org. Penaeus stylirostris - Pacific, Eastern Central - Mexican Secretary of Agriculture and Rural Development - Mexico National Commission of Aquaculture and Fisheries - Pacific, Eastern Central - Mexico - Drift gillnets. In: Global Record of Stocks and Fisheries (GRSF). Consiglio Nazionale delle Ricerche, CNR. Version: 1.0. Updated: April 03, 2024. Accessed: [Date accessed and/or downloaded]. http://data.d4science.org/ctlg/GRSF_Admin/00454650-b66c-32f9-ae32-eff038dd1e1d. Database sources: [FishSource]"
+        },
+        {
+            "key": "Domain",
+            "value": "Traceability Unit"
+        },
+        {
+            "key": "GRSF UUID",
+            "value": "00454650-b66c-32f9-ae32-eff038dd1e1d"
+        },
+        {
+            "key": "Record URL",
+            "value": "https://data.d4science.org/ctlg/GRSF_Admin/00454650-b66c-32f9-ae32-eff038dd1e1d"
+        },
+        {
+            "key": "system:type",
+            "value": "Traceability Unit"
+        },
+        {
+            "key": "traceability_unit_identity:Assessment Area",
+            "value": "Code: 77, System: FAO, Name: Pacific, Eastern Central"
+        },
+        {
+            "key": "traceability_unit_identity:Connected Fishery Record",
+            "value": "https://data.d4science.org/ctlg/GRSF_Admin/66e3df5d-be9f-3661-b27b-282a5da3c820"
+        },
+        {
+            "key": "traceability_unit_identity:Connected Stock Record",
+            "value": "https://data.d4science.org/ctlg/GRSF_Admin/4d9033c3-caf2-3500-beb8-0f5684d29199"
+        },
+        {
+            "key": "traceability_unit_identity:Database Source",
+            "value": "FishSource"
+        },
+        {
+            "key": "traceability_unit_identity:Fishing Gear",
+            "value": "Code: 07.2, System: ISSCFG, Name: Drift gillnets"
+        },
+        {
+            "key": "traceability_unit_identity:Flag State",
+            "value": "Code: MEX, System: ISO3, Name: Mexico"
+        },
+        {
+            "key": "traceability_unit_identity:GRSF Semantic Identifier",
+            "value": "asfis:PNS+fao:77+authority:NAT:MEX+fao:77+iso3:MEX+isscfg:07.2"
+        },
+        {
+            "key": "traceability_unit_identity:GRSF Traceability Unit Name",
+            "value": "Penaeus stylirostris - Pacific, Eastern Central - Mexican Secretary of Agriculture and Rural Development - Mexico National Commission of Aquaculture and Fisheries - Pacific, Eastern Central - Mexico - Drift gillnets"
+        },
+        {
+            "key": "traceability_unit_identity:GRSF Type",
+            "value": "Traceability Unit"
+        },
+        {
+            "key": "traceability_unit_identity:Management Body/Authority",
+            "value": "Code: authority:NAT:MEX, System: GRSF-ORG, Name: Mexico National Commission of Aquaculture and Fisheries"
+        },
+        {
+            "key": "traceability_unit_identity:Management Body/Authority",
+            "value": "Code: authority:NAT:MEX, System: GRSF-ORG, Name: Mexican Secretary of Agriculture and Rural Development"
+        },
+        {
+            "key": "traceability_unit_identity:Management/Reporting Area",
+            "value": "Code: 77, System: FAO, Name: Pacific, Eastern Central"
+        },
+        {
+            "key": "traceability_unit_identity:Short Name",
+            "value": "Blue shrimp | Upper Gulf of California | Mexico Pacific artisanal | Mexico | Drift gillnets - Blue shrimp - Upper Gulf of California"
+        },
+        {
+            "key": "traceability_unit_identity:Species",
+            "value": "Code: PNS, Classification System: ASFIS, Scientific Name: Penaeus stylirostris"
+        }
+    ],
+    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+    "ratings_count": 0,
+    "title": "Penaeus stylirostris - Pacific, Eastern Central - Mexican Secretary of Agriculture and Rural Development - Mexico National Commission of Aquaculture and Fisheries - Pacific, Eastern Central - Mexico - Drift gillnets",
+    "revision_id": "23191a39-36bf-4a36-ad42-0df374624c3e"
+}
\ No newline at end of file
diff --git a/src/main/resources/api-docs-examples/traceability-unit/read-traceability-unit-response.json b/src/main/resources/api-docs-examples/traceability-unit/read-traceability-unit-response.json
new file mode 100644
index 0000000..f2f85ac
--- /dev/null
+++ b/src/main/resources/api-docs-examples/traceability-unit/read-traceability-unit-response.json
@@ -0,0 +1,251 @@
+{
+    "rating": 0.0,
+    "license_title": "Creative Commons Attribution Share-Alike 4.0",
+    "maintainer": "GRSF Publisher",
+    "relationships_as_object": [],
+    "private": true,
+    "maintainer_email": "grsf_publisher@d4science.org",
+    "num_tags": 5,
+    "id": "7179c93c-ef71-4d10-9778-12248bb8e300",
+    "metadata_created": "2024-04-10T15:40:22.225680",
+    "metadata_modified": "2024-04-10T15:40:22.225688",
+    "author": "GRSF Publisher",
+    "author_email": "grsf_publisher@d4science.org",
+    "state": "active",
+    "version": "1.0",
+    "creator_user_id": "8c77d7d6-17e1-4f72-be95-640bc42e5c80",
+    "type": "dataset",
+    "resources": [
+        {
+            "mimetype": null,
+            "cache_url": null,
+            "hash": "",
+            "description": "asfis:PNS+fao:77",
+            "name": "GRSF Stock",
+            "format": "",
+            "url": "https://data.d4science.org/ctlg/GRSF_Admin/4d9033c3-caf2-3500-beb8-0f5684d29199",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "7179c93c-ef71-4d10-9778-12248bb8e300",
+            "created": "2024-04-10T15:40:22.230543",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 0,
+            "revision_id": "23191a39-36bf-4a36-ad42-0df374624c3e",
+            "url_type": null,
+            "id": "cad1413a-1d45-4c7a-a550-802a00536172",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": null,
+            "cache_url": null,
+            "hash": "",
+            "description": "asfis:PNS+fao:77+authority:NAT:MEX+iso3:MEX+isscfg:07.2",
+            "name": "GRSF Fishery",
+            "format": "",
+            "url": "https://data.d4science.org/ctlg/GRSF_Admin/66e3df5d-be9f-3661-b27b-282a5da3c820",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "7179c93c-ef71-4d10-9778-12248bb8e300",
+            "created": "2024-04-10T15:40:22.230550",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 1,
+            "revision_id": "23191a39-36bf-4a36-ad42-0df374624c3e",
+            "url_type": null,
+            "id": "2b258919-5af6-46a3-9097-4506819226ec",
+            "resource_type": null,
+            "size": null
+        },
+        {
+            "mimetype": null,
+            "cache_url": null,
+            "hash": "",
+            "description": "",
+            "name": "Traceability Unit URI",
+            "format": "",
+            "url": "https://github.com/grsf/resource/traceability_unit/00454650-b66c-32f9-ae32-eff038dd1e1d",
+            "datastore_active": false,
+            "cache_last_updated": null,
+            "package_id": "7179c93c-ef71-4d10-9778-12248bb8e300",
+            "created": "2024-04-10T15:40:22.230554",
+            "state": "active",
+            "mimetype_inner": null,
+            "last_modified": null,
+            "position": 2,
+            "revision_id": "23191a39-36bf-4a36-ad42-0df374624c3e",
+            "url_type": null,
+            "id": "fefaa87d-11b1-43d1-8726-f649e7c92e3d",
+            "resource_type": null,
+            "size": null
+        }
+    ],
+    "num_resources": 3,
+    "tags": [
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code 072 System ISSCFG Name Drift gillnets",
+            "id": "c7f1e884-afdf-47ae-ade6-928d8874c800",
+            "name": "Code 072 System ISSCFG Name Drift gillnets"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code 77 System FAO Name Pacific Eastern Central",
+            "id": "55427764-bbd3-4911-a716-37f2b34fe629",
+            "name": "Code 77 System FAO Name Pacific Eastern Central"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code MEX System ISO3 Name Mexico",
+            "id": "1370b3ae-7471-44a1-9106-204d4ac09296",
+            "name": "Code MEX System ISO3 Name Mexico"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Code PNS Classification System ASFIS Scientific Name Penaeus stylirostris",
+            "id": "1bac544c-a6ec-44b4-bf5d-743449bbac67",
+            "name": "Code PNS Classification System ASFIS Scientific Name Penaeus stylirostris"
+        },
+        {
+            "vocabulary_id": null,
+            "state": "active",
+            "display_name": "Traceability Unit",
+            "id": "b12869ca-7fe5-48e0-9fe6-09e957202797",
+            "name": "Traceability Unit"
+        }
+    ],
+    "groups": [
+        {
+            "display_name": "FishSource",
+            "description": "",
+            "image_display_url": "",
+            "title": "FishSource",
+            "id": "42b31b78-24d9-4695-a1e8-76fe836603bc",
+            "name": "fishsource-group"
+        },
+        {
+            "display_name": "GRSF",
+            "description": "",
+            "image_display_url": "",
+            "title": "GRSF",
+            "id": "016d24fc-51b2-4f61-a58d-f37e96022891",
+            "name": "grsf-group"
+        },
+        {
+            "display_name": "Traceability Unit",
+            "description": "",
+            "image_display_url": "",
+            "title": "Traceability Unit",
+            "id": "2a7d503f-d961-4a32-8df0-1299596209bd",
+            "name": "traceability-unit-group"
+        }
+    ],
+    "license_id": "CC-BY-SA-4.0",
+    "relationships_as_subject": [],
+    "organization": {
+        "description": "Global Record of Stocks and Fisheries (GRSF)",
+        "created": "2024-03-18T14:57:25.062819",
+        "title": "GRSF",
+        "name": "grsf",
+        "is_organization": true,
+        "state": "active",
+        "image_url": "",
+        "revision_id": "1f2048ab-97ec-4502-8bdb-1dc0136489e4",
+        "type": "organization",
+        "id": "8c3f99db-fd09-4341-b060-87a7c902bc5d",
+        "approval_status": "approved"
+    },
+    "name": "00454650-b66c-32f9-ae32-eff038dd1e1d",
+    "isopen": true,
+    "url": null,
+    "notes": "Short Name: Blue shrimp | Upper Gulf of California | Mexico Pacific artisanal | Mexico | Drift gillnets - Blue shrimp - Upper Gulf of California\nGRSF Semantic Identifier: asfis:PNS+fao:77+authority:NAT:MEX+fao:77+iso3:MEX+isscfg:07.2\nRecord URL: https://data-pre.d4science.org/ctlg/GRSF_Pre/00454650-b66c-32f9-ae32-eff038dd1e1d",
+    "extras": [
+        {
+            "key": "Citation",
+            "value": "© D4Science.org. Penaeus stylirostris - Pacific, Eastern Central - Mexican Secretary of Agriculture and Rural Development - Mexico National Commission of Aquaculture and Fisheries - Pacific, Eastern Central - Mexico - Drift gillnets. In: Global Record of Stocks and Fisheries (GRSF). Consiglio Nazionale delle Ricerche, CNR. Version: 1.0. Updated: April 03, 2024. Accessed: [Date accessed and/or downloaded]. http://data.d4science.org/ctlg/GRSF_Admin/00454650-b66c-32f9-ae32-eff038dd1e1d. Database sources: [FishSource]"
+        },
+        {
+            "key": "Domain",
+            "value": "Traceability Unit"
+        },
+        {
+            "key": "GRSF UUID",
+            "value": "00454650-b66c-32f9-ae32-eff038dd1e1d"
+        },
+        {
+            "key": "Record URL",
+            "value": "https://data.d4science.org/ctlg/GRSF_Admin/00454650-b66c-32f9-ae32-eff038dd1e1d"
+        },
+        {
+            "key": "system:type",
+            "value": "Traceability Unit"
+        },
+        {
+            "key": "traceability_unit_identity:Assessment Area",
+            "value": "Code: 77, System: FAO, Name: Pacific, Eastern Central"
+        },
+        {
+            "key": "traceability_unit_identity:Connected Fishery Record",
+            "value": "https://data.d4science.org/ctlg/GRSF_Admin/66e3df5d-be9f-3661-b27b-282a5da3c820"
+        },
+        {
+            "key": "traceability_unit_identity:Connected Stock Record",
+            "value": "https://data.d4science.org/ctlg/GRSF_Admin/4d9033c3-caf2-3500-beb8-0f5684d29199"
+        },
+        {
+            "key": "traceability_unit_identity:Database Source",
+            "value": "FishSource"
+        },
+        {
+            "key": "traceability_unit_identity:Fishing Gear",
+            "value": "Code: 07.2, System: ISSCFG, Name: Drift gillnets"
+        },
+        {
+            "key": "traceability_unit_identity:Flag State",
+            "value": "Code: MEX, System: ISO3, Name: Mexico"
+        },
+        {
+            "key": "traceability_unit_identity:GRSF Semantic Identifier",
+            "value": "asfis:PNS+fao:77+authority:NAT:MEX+fao:77+iso3:MEX+isscfg:07.2"
+        },
+        {
+            "key": "traceability_unit_identity:GRSF Traceability Unit Name",
+            "value": "Penaeus stylirostris - Pacific, Eastern Central - Mexican Secretary of Agriculture and Rural Development - Mexico National Commission of Aquaculture and Fisheries - Pacific, Eastern Central - Mexico - Drift gillnets"
+        },
+        {
+            "key": "traceability_unit_identity:GRSF Type",
+            "value": "Traceability Unit"
+        },
+        {
+            "key": "traceability_unit_identity:Management Body/Authority",
+            "value": "Code: authority:NAT:MEX, System: GRSF-ORG, Name: Mexico National Commission of Aquaculture and Fisheries"
+        },
+        {
+            "key": "traceability_unit_identity:Management Body/Authority",
+            "value": "Code: authority:NAT:MEX, System: GRSF-ORG, Name: Mexican Secretary of Agriculture and Rural Development"
+        },
+        {
+            "key": "traceability_unit_identity:Management/Reporting Area",
+            "value": "Code: 77, System: FAO, Name: Pacific, Eastern Central"
+        },
+        {
+            "key": "traceability_unit_identity:Short Name",
+            "value": "Blue shrimp | Upper Gulf of California | Mexico Pacific artisanal | Mexico | Drift gillnets - Blue shrimp - Upper Gulf of California"
+        },
+        {
+            "key": "traceability_unit_identity:Species",
+            "value": "Code: PNS, Classification System: ASFIS, Scientific Name: Penaeus stylirostris"
+        }
+    ],
+    "license_url": "https://creativecommons.org/licenses/by-sa/4.0/",
+    "ratings_count": 0,
+    "title": "Penaeus stylirostris - Pacific, Eastern Central - Mexican Secretary of Agriculture and Rural Development - Mexico National Commission of Aquaculture and Fisheries - Pacific, Eastern Central - Mexico - Drift gillnets",
+    "revision_id": "23191a39-36bf-4a36-ad42-0df374624c3e"
+}
\ No newline at end of file
diff --git a/src/test/java/org/gcube/grsf/publisher/record/RecordTest.java b/src/test/java/org/gcube/grsf/publisher/record/RecordTest.java
index e1f87cc..fe8e1d1 100644
--- a/src/test/java/org/gcube/grsf/publisher/record/RecordTest.java
+++ b/src/test/java/org/gcube/grsf/publisher/record/RecordTest.java
@@ -21,10 +21,10 @@ import org.gcube.com.fasterxml.jackson.databind.ObjectMapper;
 import org.gcube.com.fasterxml.jackson.databind.node.ArrayNode;
 import org.gcube.com.fasterxml.jackson.databind.node.ObjectNode;
 import org.gcube.grsf.publisher.ContextTest;
-import org.gcube.grsf.publisher.ckan.record.Fishery;
+import org.gcube.grsf.publisher.ckan.record.FisheryRecord;
 import org.gcube.grsf.publisher.ckan.record.Record;
-import org.gcube.grsf.publisher.ckan.record.Stock;
-import org.gcube.grsf.publisher.ckan.record.TraceabilityUnit;
+import org.gcube.grsf.publisher.ckan.record.StockRecord;
+import org.gcube.grsf.publisher.ckan.record.TraceabilityUnitRecord;
 import org.gcube.grsf.publisher.freemarker.FreeMarker;
 import org.gcube.grsf.publisher.freemarker.FreeMarkerTest;
 import org.junit.Assert;
@@ -159,15 +159,15 @@ public class RecordTest extends ContextTest {
 		Record record;
 		switch (type) {
 			case FISHERY:
-				record = new Fishery();
+				record = new FisheryRecord();
 				break;
 
 			case STOCK:
-				record = new Stock();
+				record = new StockRecord();
 				break;
 
 			case TRACEABILITY_UNIT:
-				record = new TraceabilityUnit();
+				record = new TraceabilityUnitRecord();
 				break;
 
 			default: