Study List
API endpoint that allows Studies to be viewed or edited.
» click to learn about Filtering, Ordering and more...
Accepted filters:
- id: ID (exact)
- created: Created (exact)
- modified: Modified (exact)
- name: Name starts with (istartswith)
- description: Description contains (icontains)
- query: Search filter on the name property (exact)
- owner: Owner Username (exact)
- owned_by: Filter on list of owned by group names [OR] (exact)
- public: Public (exact)
- deleted: Deleted (exact)
- deleted_by: Deleted by (exact)
- deleted_date: Deleted date (exact)
- project: Project Name (iexact)
- created_by: Created by Username (exact)
- modified_by: Modified by Username (exact)
Advanced Filtering
You can also filter using a json object to process all search parameters. Currently this filter supports the syntax as produced/used by the http://summitroute.github.io/react-structured-filter/ search UI.
Example
?query_expression={"category":"name","operator":"contains","value":"Y00"},
{"category":"amount","operator":">","value":"10"},
{"category":"type__name","operator":"exact","value":"ANTIBODY"}
» more info about the query_expression param..
Preset mappings
- project: project__name
- number_of_datasets: <function filter_by_number_of_datasets at 0x7f45063b65f0>
- deleted: <function filter_deleted at 0x7f45063b6710>
- deleted_by: deleted_by__username
- notes: notes__content
- owner: owner__username
- owned_by: owned_by__name
- created_by: created_by__username
- modified_by: modified_by__username
Operators
- ==
- =
- >=
- >
- <=
- <
- contains
- icontains
- exact
- iexact
- startswith
- istartswith
- endswith
- iendswith
Permission filtering
Based on the current logged in user you can filter for objects that have a particular permission set:
- can_change: True/False, show objects that you can change
- can_delete: True/False, show objects that you can delete
# not applicable - will raise NotAcceptable:
- can_view: as this is always True, you can only view items you are allowed to see
Ordering
You can order on practically any field even spanning relations.
# reverse order on owner username
?ordering=-owner
# order on related field
?ordering=category__version
API endpoint that allows Studies to be viewed or edited.
None
The default modelviewset used in this project
Add JSONPatch like functionality to bulk update items.
### Bulk Delete
This view also allows for one to bulk delete items. The url needs to be appended by ``/bulk_delete/`` and the ids
need to be given by multiple query_params:
```
{current_url}/bulk_delete/?id=<id_1>,id=<id_2>
```
GET /api/v2/core/studies/?format=api&ordering=archives
{ "previous": null, "next": null, "current": 1, "total": 5, "total_pages": 1, "results": [ { "url": { "name": "url", "value": "https://labid-demo.embl.de/api/v2/core/studies/50e9b85b-7e41-4a40-8215-e9f8da783c70/?format=api", "category": "property" }, "id": { "name": "id", "category": "property", "value": "50e9b85b-7e41-4a40-8215-e9f8da783c70" }, "created_by": { "name": "created_by", "value": { "id": 2, "username": "Anonymous", "full_name": "Anonymous User" }, "category": "property" }, "modified_by": { "name": "modified_by", "value": { "id": 2, "username": "Anonymous", "full_name": "Anonymous User" }, "category": "property" }, "created": { "name": "created", "value": "2025-12-16T09:30:16.554969+01:00", "category": "property" }, "modified": { "name": "modified", "value": "2025-12-16T09:30:16.555404+01:00", "category": "property" }, "model_name": { "name": "model_name", "category": "property", "value": "study" }, "app_name": { "name": "app_name", "category": "property", "value": "core" }, "model_type": { "name": "model_type", "category": "property", "value": "DEFAULT" }, "name": { "name": "name", "value": { "id": "50e9b85b-7e41-4a40-8215-e9f8da783c70", "name": "Proteomics Study [Anonymous]", "model_name": "study", "app_name": "core", "model_type": null }, "category": "property" }, "choice_label": { "name": "choice_label", "category": "property", "value": "Proteomics Study [Anonymous]" }, "description": { "name": "description", "category": "property", "value": "" }, "owner": { "name": "owner", "value": { "id": 2, "username": "Anonymous", "full_name": "Anonymous User" }, "category": "property" }, "owned_by": { "name": "owned_by", "value": { "id": 1, "name": "SYSTEM_GROUP" }, "category": "property" }, "number_of_datasets": { "name": "number_of_datasets", "category": "property", "value": 0 }, "project": { "name": "project", "value": { "id": "f712bfa1-0bd7-4c51-aeaa-0a2f22cc01fe", "name": "Personal Project [Anonymous]", "label": null, "deleted": false, "model_name": "project", "app_name": "core", "model_type": "DEFAULT" }, "category": "property" }, "design": { "name": "design", "value": [], "category": "property" }, "pubmed_id": { "name": "pubmed_id", "value": [], "category": "property" }, "notes": { "name": "notes", "category": "property", "value": 0 }, "archives": { "name": "archives", "value": [], "category": "property" }, "contributors": { "name": "contributors", "category": "property", "value": [] }, "required_annotations": { "name": "required_annotations", "category": "property", "value": [] }, "required_protocols": { "name": "required_protocols", "category": "property", "value": [] }, "deleted": { "name": "deleted", "value": false, "category": "property" }, "deleted_by": { "name": "deleted_by", "value": null, "category": "property" }, "deleted_date": { "name": "deleted_date", "value": null, "category": "property" }, "public": { "name": "public", "value": false, "category": "property" }, "permissions": { "name": "permissions", "value": { "public": false, "actions": {}, "allowed": [ "view", "change", "delete" ] }, "category": "property" } }, { "url": { "name": "url", "value": "https://labid-demo.embl.de/api/v2/core/studies/4497a537-e9d4-4670-b7ea-822a8603ede7/?format=api", "category": "property" }, "id": { "name": "id", "category": "property", "value": "4497a537-e9d4-4670-b7ea-822a8603ede7" }, "created_by": { "name": "created_by", "value": { "id": 2, "username": "Anonymous", "full_name": "Anonymous User" }, "category": "property" }, "modified_by": { "name": "modified_by", "value": { "id": 2, "username": "Anonymous", "full_name": "Anonymous User" }, "category": "property" }, "created": { "name": "created", "value": "2025-12-16T09:30:16.520451+01:00", "category": "property" }, "modified": { "name": "modified", "value": "2025-12-16T09:30:16.520900+01:00", "category": "property" }, "model_name": { "name": "model_name", "category": "property", "value": "study" }, "app_name": { "name": "app_name", "category": "property", "value": "core" }, "model_type": { "name": "model_type", "category": "property", "value": "DEFAULT" }, "name": { "name": "name", "value": { "id": "4497a537-e9d4-4670-b7ea-822a8603ede7", "name": "Light Microscopy Study [Anonymous]", "model_name": "study", "app_name": "core", "model_type": null }, "category": "property" }, "choice_label": { "name": "choice_label", "category": "property", "value": "Light Microscopy Study [Anonymous]" }, "description": { "name": "description", "category": "property", "value": "" }, "owner": { "name": "owner", "value": { "id": 2, "username": "Anonymous", "full_name": "Anonymous User" }, "category": "property" }, "owned_by": { "name": "owned_by", "value": { "id": 1, "name": "SYSTEM_GROUP" }, "category": "property" }, "number_of_datasets": { "name": "number_of_datasets", "category": "property", "value": 0 }, "project": { "name": "project", "value": { "id": "f712bfa1-0bd7-4c51-aeaa-0a2f22cc01fe", "name": "Personal Project [Anonymous]", "label": null, "deleted": false, "model_name": "project", "app_name": "core", "model_type": "DEFAULT" }, "category": "property" }, "design": { "name": "design", "value": [], "category": "property" }, "pubmed_id": { "name": "pubmed_id", "value": [], "category": "property" }, "notes": { "name": "notes", "category": "property", "value": 0 }, "archives": { "name": "archives", "value": [], "category": "property" }, "contributors": { "name": "contributors", "category": "property", "value": [] }, "required_annotations": { "name": "required_annotations", "category": "property", "value": [] }, "required_protocols": { "name": "required_protocols", "category": "property", "value": [] }, "deleted": { "name": "deleted", "value": false, "category": "property" }, "deleted_by": { "name": "deleted_by", "value": null, "category": "property" }, "deleted_date": { "name": "deleted_date", "value": null, "category": "property" }, "public": { "name": "public", "value": false, "category": "property" }, "permissions": { "name": "permissions", "value": { "public": false, "actions": {}, "allowed": [ "view", "change", "delete" ] }, "category": "property" } }, { "url": { "name": "url", "value": "https://labid-demo.embl.de/api/v2/core/studies/f699eba7-47a2-4604-a150-0ac94f5cf9f5/?format=api", "category": "property" }, "id": { "name": "id", "category": "property", "value": "f699eba7-47a2-4604-a150-0ac94f5cf9f5" }, "created_by": { "name": "created_by", "value": { "id": 2, "username": "Anonymous", "full_name": "Anonymous User" }, "category": "property" }, "modified_by": { "name": "modified_by", "value": { "id": 2, "username": "Anonymous", "full_name": "Anonymous User" }, "category": "property" }, "created": { "name": "created", "value": "2025-12-16T09:30:16.537857+01:00", "category": "property" }, "modified": { "name": "modified", "value": "2025-12-16T09:30:16.538307+01:00", "category": "property" }, "model_name": { "name": "model_name", "category": "property", "value": "study" }, "app_name": { "name": "app_name", "category": "property", "value": "core" }, "model_type": { "name": "model_type", "category": "property", "value": "DEFAULT" }, "name": { "name": "name", "value": { "id": "f699eba7-47a2-4604-a150-0ac94f5cf9f5", "name": "Electron Microscopy Study [Anonymous]", "model_name": "study", "app_name": "core", "model_type": null }, "category": "property" }, "choice_label": { "name": "choice_label", "category": "property", "value": "Electron Microscopy Study [Anonymous]" }, "description": { "name": "description", "category": "property", "value": "" }, "owner": { "name": "owner", "value": { "id": 2, "username": "Anonymous", "full_name": "Anonymous User" }, "category": "property" }, "owned_by": { "name": "owned_by", "value": { "id": 1, "name": "SYSTEM_GROUP" }, "category": "property" }, "number_of_datasets": { "name": "number_of_datasets", "category": "property", "value": 0 }, "project": { "name": "project", "value": { "id": "f712bfa1-0bd7-4c51-aeaa-0a2f22cc01fe", "name": "Personal Project [Anonymous]", "label": null, "deleted": false, "model_name": "project", "app_name": "core", "model_type": "DEFAULT" }, "category": "property" }, "design": { "name": "design", "value": [], "category": "property" }, "pubmed_id": { "name": "pubmed_id", "value": [], "category": "property" }, "notes": { "name": "notes", "category": "property", "value": 0 }, "archives": { "name": "archives", "value": [], "category": "property" }, "contributors": { "name": "contributors", "category": "property", "value": [] }, "required_annotations": { "name": "required_annotations", "category": "property", "value": [] }, "required_protocols": { "name": "required_protocols", "category": "property", "value": [] }, "deleted": { "name": "deleted", "value": false, "category": "property" }, "deleted_by": { "name": "deleted_by", "value": null, "category": "property" }, "deleted_date": { "name": "deleted_date", "value": null, "category": "property" }, "public": { "name": "public", "value": false, "category": "property" }, "permissions": { "name": "permissions", "value": { "public": false, "actions": {}, "allowed": [ "view", "change", "delete" ] }, "category": "property" } }, { "url": { "name": "url", "value": "https://labid-demo.embl.de/api/v2/core/studies/310da002-8376-4d1e-adf1-96d5a33ba814/?format=api", "category": "property" }, "id": { "name": "id", "category": "property", "value": "310da002-8376-4d1e-adf1-96d5a33ba814" }, "created_by": { "name": "created_by", "value": { "id": 3, "username": "demo", "full_name": "Demo User" }, "category": "property" }, "modified_by": { "name": "modified_by", "value": { "id": 3, "username": "demo", "full_name": "Demo User" }, "category": "property" }, "created": { "name": "created", "value": "2025-12-16T09:33:22.097300+01:00", "category": "property" }, "modified": { "name": "modified", "value": "2025-12-16T09:33:22.098319+01:00", "category": "property" }, "model_name": { "name": "model_name", "category": "property", "value": "study" }, "app_name": { "name": "app_name", "category": "property", "value": "core" }, "model_type": { "name": "model_type", "category": "property", "value": "DEFAULT" }, "name": { "name": "name", "value": { "id": "310da002-8376-4d1e-adf1-96d5a33ba814", "name": "Liver RNA", "model_name": "study", "app_name": "core", "model_type": null }, "category": "property" }, "choice_label": { "name": "choice_label", "category": "property", "value": "Liver RNA" }, "description": { "name": "description", "category": "property", "value": "" }, "owner": { "name": "owner", "value": { "id": 3, "username": "demo", "full_name": "Demo User" }, "category": "property" }, "owned_by": { "name": "owned_by", "value": { "id": 2, "name": "Demo" }, "category": "property" }, "number_of_datasets": { "name": "number_of_datasets", "category": "property", "value": 1 }, "project": { "name": "project", "value": { "id": "454e92b4-4525-4e32-91e2-a80448578975", "name": "Balb/C demo Project", "label": null, "deleted": false, "model_name": "project", "app_name": "core", "model_type": "DEFAULT" }, "category": "property" }, "design": { "name": "design", "value": [], "category": "property" }, "pubmed_id": { "name": "pubmed_id", "value": [], "category": "property" }, "notes": { "name": "notes", "category": "property", "value": 0 }, "archives": { "name": "archives", "value": [], "category": "property" }, "contributors": { "name": "contributors", "category": "property", "value": [] }, "required_annotations": { "name": "required_annotations", "category": "property", "value": [] }, "required_protocols": { "name": "required_protocols", "category": "property", "value": [] }, "deleted": { "name": "deleted", "value": false, "category": "property" }, "deleted_by": { "name": "deleted_by", "value": null, "category": "property" }, "deleted_date": { "name": "deleted_date", "value": null, "category": "property" }, "public": { "name": "public", "value": true, "category": "property" }, "permissions": { "name": "permissions", "value": { "public": true, "actions": {}, "allowed": [ "view" ] }, "category": "property" } }, { "url": { "name": "url", "value": "https://labid-demo.embl.de/api/v2/core/studies/bb860627-5d29-406e-8230-fb0c4745d012/?format=api", "category": "property" }, "id": { "name": "id", "category": "property", "value": "bb860627-5d29-406e-8230-fb0c4745d012" }, "created_by": { "name": "created_by", "value": { "id": 2, "username": "Anonymous", "full_name": "Anonymous User" }, "category": "property" }, "modified_by": { "name": "modified_by", "value": { "id": 2, "username": "Anonymous", "full_name": "Anonymous User" }, "category": "property" }, "created": { "name": "created", "value": "2025-12-16T09:30:16.493499+01:00", "category": "property" }, "modified": { "name": "modified", "value": "2025-12-16T09:30:16.494202+01:00", "category": "property" }, "model_name": { "name": "model_name", "category": "property", "value": "study" }, "app_name": { "name": "app_name", "category": "property", "value": "core" }, "model_type": { "name": "model_type", "category": "property", "value": "DEFAULT" }, "name": { "name": "name", "value": { "id": "bb860627-5d29-406e-8230-fb0c4745d012", "name": "Sequencing Study [Anonymous]", "model_name": "study", "app_name": "core", "model_type": null }, "category": "property" }, "choice_label": { "name": "choice_label", "category": "property", "value": "Sequencing Study [Anonymous]" }, "description": { "name": "description", "category": "property", "value": "" }, "owner": { "name": "owner", "value": { "id": 2, "username": "Anonymous", "full_name": "Anonymous User" }, "category": "property" }, "owned_by": { "name": "owned_by", "value": { "id": 1, "name": "SYSTEM_GROUP" }, "category": "property" }, "number_of_datasets": { "name": "number_of_datasets", "category": "property", "value": 0 }, "project": { "name": "project", "value": { "id": "f712bfa1-0bd7-4c51-aeaa-0a2f22cc01fe", "name": "Personal Project [Anonymous]", "label": null, "deleted": false, "model_name": "project", "app_name": "core", "model_type": "DEFAULT" }, "category": "property" }, "design": { "name": "design", "value": [], "category": "property" }, "pubmed_id": { "name": "pubmed_id", "value": [], "category": "property" }, "notes": { "name": "notes", "category": "property", "value": 0 }, "archives": { "name": "archives", "value": [], "category": "property" }, "contributors": { "name": "contributors", "category": "property", "value": [] }, "required_annotations": { "name": "required_annotations", "category": "property", "value": [] }, "required_protocols": { "name": "required_protocols", "category": "property", "value": [] }, "deleted": { "name": "deleted", "value": false, "category": "property" }, "deleted_by": { "name": "deleted_by", "value": null, "category": "property" }, "deleted_date": { "name": "deleted_date", "value": null, "category": "property" }, "public": { "name": "public", "value": false, "category": "property" }, "permissions": { "name": "permissions", "value": { "public": false, "actions": {}, "allowed": [ "view", "change", "delete" ] }, "category": "property" } } ] }