MENU navbar-image

Introduction

The EU Pollinator Hub is an integrative tool to centralise, analyse and visualise bee and pollinator-related data based on principles of collaboration and conservation.
Bees and other insect pollinators are becoming increasingly relevant in the public debate. European authorities now recognise the environmental risks pollinators face and the need for institutional action. Given their importance for ecosystems and their role in our food security, the commitment to protect pollinators has been growing, and data is essential to fulfilling this commitment.
Different agents and stakeholders are continually collecting data related to the status of pollinators, such as researchers, environmental, health or agricultural authorities, national beekeeping or farming associations. The EU Pollinator Hub has been conceived to valorise their efforts and improve collaborations based on data-sharing. At the same time, the EU Pollinator Hub is constantly developing to provide access to valuable data from different consenting sources. In a collaborative spirit, the EU Pollinator Hub centralises and presents this data, also working as a communicative tool for the benefit of bees and pollinators in general.
The EU Pollinator Hub is coordinated by BeeLife European Beekeeping Coordination, an NGO focused on the protection of pollinators and biodiversity in Europe. BeeLife has initialised the first stages of this integrative platform within the Internet of Bees (IoBee) project.
The EU Pollinator Hub is also an attempt to materialise the conclusions of the EU Bee Partnership regarding the need for further bee-data integration. The partnership is a stakeholder platform dynamised by the European Food Safety Authority that includes representatives from the beekeeping and farming sectors, NGOs, veterinarians, academia, industry, producers, and scientists.
This new tool also includes developments from the Apimondia working group on the standardisation of data on bees - Bee XML. Bee XML is the ongoing measure to reach a new model for sharing bee data, and the EU Pollinator Hub aims at implementing these standards.

This documentation aims to provide all the information you need to work with our API.

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer {YOUR_AUTH_KEY}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can retrieve your token by visiting your dashboard and clicking API Tokens.

Discovery

Publicly accessible routes, that do not require any special permissions.

Pipeline health check

requires authentication

Tests whether the API functions according to expectations. Should return "status": "OK" when successful.

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/status" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/status';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/status"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/status'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 59
access-control-allow-origin: *
 

{
    "status": "OK"
}
 

Request   

GET api/v1/status

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

List datasets

requires authentication

Get a list of all publicly accessible datasets. Does not return all metadata fields contained within the dataset. Only returns datasets with completely integrated data. Note, list contains publicly inaccessible datasets as well (see attribute public). Uses pagination.

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=1&limit=3" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/discovery/datasets';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'page' => '1',
            'limit' => '3',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/discovery/datasets"
);

const params = {
    "page": "1",
    "limit": "3",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/discovery/datasets'
params = {
  'page': '1',
  'limit': '3',
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Example response (200):

Show headers
cache-control: cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 58
access-control-allow-origin: *
 

{
    "current_page": 1,
    "data": [
        {
            "id": 2,
            "uid": "CNTRS2.0.0",
            "name": "Countries",
            "long_name": "EUPH reference dataset containing names and codes of countries, aggregates and subdivisions of countries",
            "description": "The dataset contains standardised information on countries published by the Organization for Standardization (ISO) and the United Nations Statistics Division (UNSD).",
            "featured_image": null,
            "status": "publish",
            "public": false,
            "licence": "EU Pollinator Hub",
            "published_at": "2023-01-25T23:00:00.000000Z",
            "created_at": "2023-01-26T18:18:06.000000Z",
            "updated_at": "2025-04-18T09:26:56.000000Z"
        },
        {
            "id": 20,
            "uid": "LNGGE20.0.0",
            "name": "Language",
            "long_name": "Partial content of ISO 639 containing information on languages",
            "description": "This dataset contains information on languages spoken worldwide and contained in ISO 639-3:2007 (codes for the representation of names of languages — Part 3: Alpha-3 code for comprehensive coverage of languages) as well as official languages in the European Union, as defined in Regulation No 1 from 1958, as amended, determining the languages to be used by the European Economic Community.",
            "featured_image": null,
            "status": "publish",
            "public": false,
            "licence": "EU Pollinator Hub",
            "published_at": "2023-03-22T23:00:00.000000Z",
            "created_at": "2023-01-26T18:18:06.000000Z",
            "updated_at": "2024-01-26T17:32:58.000000Z"
        },
        {
            "id": 27,
            "uid": "PHRFR27.0.0",
            "name": "EUPH Reference licences",
            "long_name": "List of licences by which datasets are published on the EU Pollinator Hub",
            "description": "The dataset contains all licences for data hosted on the EUPH.",
            "featured_image": null,
            "status": "publish",
            "public": false,
            "licence": "CC BY 4.0",
            "published_at": "2023-03-27T22:00:00.000000Z",
            "created_at": "2023-09-01T08:53:39.000000Z",
            "updated_at": "2024-02-01T14:25:03.000000Z"
        }
    ],
    "first_page_url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=1",
    "from": 1,
    "last_page": 4,
    "last_page_url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=4",
    "links": [
        {
            "url": null,
            "label": "« Previous",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=1",
            "label": "1",
            "active": true
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=2",
            "label": "2",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=3",
            "label": "3",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=4",
            "label": "4",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=2",
            "label": "Next »",
            "active": false
        }
    ],
    "next_page_url": "https://app.pollinatorhub.eu/api/v1/discovery/datasets?page=2",
    "path": "https://app.pollinatorhub.eu/api/v1/discovery/datasets",
    "per_page": 3,
    "prev_page_url": null,
    "to": 3,
    "total": 11
}
 

Request   

GET api/v1/discovery/datasets

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

Query Parameters

page   integer  optional  

Load specified page to view the results. Default: 1 Example: 1

limit   integer  optional  

Set the amount of results the API returns. Up to 1000. Default: 100 Example: 3

Response

Response Fields

data   object[]   

A list of Datasets available to the User.

*   object   
uid   string   

The unique identifier used to identify the entity within the platform.

name   string   

The actual name of the dataset.

long_name   string   

The long version of the name of the dataset.

description   string   

The abstract of the dataset.

status   string   

The status of the dataset. The list of available status are the following: draft, pending, reject, reviewing, pending-peer-rev, peer-reviewing, publish, publish-with-pw, trash, hidden

public   boolean   

1 means that the data of this dataset are public.

licence   string|null   

The uid of the licence of this entity.

published_at   string|null   

The date and time the dataset was published.

created_at   string   

The date and time the dataset was created.

updated_at   string   

The date and time the dataset was last updated.

id   integer   

The internal id of the dataset.

Show dataset

requires authentication

Get detailed information about specific dataset.

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/discovery/datasets/RGLTN80.0.0" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/discovery/datasets/RGLTN80.0.0';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/discovery/datasets/RGLTN80.0.0"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/discovery/datasets/RGLTN80.0.0'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):

Show headers
cache-control: cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 57
access-control-allow-origin: *
 

{
    "data": {
        "id": 80,
        "uid": "RGLTN80.0.0",
        "name": "Regulation (EU) 2017/269",
        "long_name": "The Harmonised classification of substances according to Regulation (EU) 2017/269 amending Regulation (EC) No 1185/2009.",
        "description": "The dataset contains the harmonised classification of substances contained in annex III of Commission Regulation (EU) 2017/269 of 16 February 2017 amending Regulation (EC) No 1185/2009 of the European Parliament and of the Council concerning statistics on pesticides, as regards the list of active substances.",
        "featured_image": null,
        "data_overview": null,
        "data_value": null,
        "data_description": null,
        "data_application": null,
        "data_issues": null,
        "introduction": null,
        "acquisition": null,
        "preparation": null,
        "validation": null,
        "analysis": null,
        "status": "publish",
        "public": true,
        "licence": {
            "uid": "cc-by-4-0",
            "name": "CC BY 4.0",
            "abbreviation": "CC BY 4.0",
            "description": "### You are free to:\n\n* Share — copy and redistribute the material in any medium or format for any purpose, even commercially.\n* Adapt — remix, transform, and build upon the material for any purpose, even commercially.\n* The licensor cannot revoke these freedoms as long as you follow the license terms.\n\n### Under the following terms:\n\n* Attribution - You must give appropriate credit , provide a link to the license, and indicate if changes were made . You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.\n* No additional restrictions - You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.\n\n### Notices:\n\nYou do not have to comply with the license for elements of the material in the public domain or where your use is permitted by an applicable exception or limitation.\n\nNo warranties are given. The license may not give you all of the permissions necessary for your intended use. For example, other rights such as publicity, privacy, or moral rights may limit how you use the material.\n",
            "url_summary": "https://creativecommons.org/licenses/by/4.0/",
            "url_legal": "https://creativecommons.org/licenses/by/4.0/legalcode",
            "image_url": "/storage/01HF961C5YQASH3TQ6MNYKN9WN.svg"
        },
        "contacts": [],
        "entities": [
            {
                "id": 3,
                "uid": "euph",
                "name": "EU Pollinator Hub",
                "type": "legal-entity",
                "abbreviation": "EUPH",
                "created_at": "2023-10-05T10:02:30.000000Z",
                "updated_at": "2024-06-04T12:59:02.000000Z"
            }
        ],
        "contributors": [],
        "parts": [
            {
                "id": 149,
                "uid": "RGLTN80.HRMNS149.0",
                "name": "Harmonised classification - CAS",
                "description": "The tabe contains the CAS codes corrisponding to a given code of the harmonised classification of substances.",
                "featured_image": null,
                "structure": null,
                "preparation": null,
                "changes": null,
                "unresolved": null,
                "additional_information": null,
                "type": "file",
                "licence": null,
                "columns": [
                    {
                        "id": 1216,
                        "name": "code",
                        "description": "Code of the Harmonised Classification of Substances",
                        "descriptor": {
                            "id": 315,
                            "uid": "0.0.TEXTA315",
                            "namespace": null,
                            "name": "Text",
                            "description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
                            "class": "[EUPH-code: 7322]",
                            "unit": null,
                            "created_at": null,
                            "updated_at": "2024-09-14T11:17:02.000000Z"
                        },
                        "unit": null,
                        "datatype": null,
                        "order": 0,
                        "created_at": "2023-12-13T17:17:11.000000Z",
                        "updated_at": "2024-01-26T18:23:50.000000Z"
                    },
                    {
                        "id": 1217,
                        "name": "cas",
                        "description": "Chemical Abstracts Service registry numbers.",
                        "descriptor": {
                            "id": 315,
                            "uid": "0.0.TEXTA315",
                            "namespace": null,
                            "name": "Text",
                            "description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
                            "class": "[EUPH-code: 7322]",
                            "unit": null,
                            "created_at": null,
                            "updated_at": "2024-09-14T11:17:02.000000Z"
                        },
                        "unit": null,
                        "datatype": null,
                        "order": 0,
                        "created_at": "2023-12-13T17:17:11.000000Z",
                        "updated_at": "2024-01-26T18:23:50.000000Z"
                    }
                ],
                "data_files": [
                    {
                        "id": 282,
                        "name": "euph_000046_eu-regulation-2017-269_table_harmonised_cas.csv",
                        "description": null,
                        "status": "analyzed",
                        "type": "csv",
                        "mimetype": "text/csv",
                        "file_size": 11843,
                        "download_count": 0,
                        "created_at": "2023-12-13T17:17:40.000000Z",
                        "updated_at": "2023-12-13T17:17:40.000000Z"
                    }
                ],
                "supplemental_files": [],
                "created_at": "2023-12-13T16:40:42.000000Z",
                "updated_at": "2024-01-25T09:26:58.000000Z"
            },
            {
                "id": 150,
                "uid": "RGLTN80.HRMNS150.0",
                "name": "Harmonised classification - CIPAC",
                "description": "The tabe contains the CIPA codes corrisponding to a given code of the harmonised classification of substances.",
                "featured_image": null,
                "structure": null,
                "preparation": null,
                "changes": null,
                "unresolved": null,
                "additional_information": null,
                "type": "file",
                "licence": null,
                "columns": [
                    {
                        "id": 1214,
                        "name": "code",
                        "description": "Code of the harmonised classification of substances",
                        "descriptor": {
                            "id": 315,
                            "uid": "0.0.TEXTA315",
                            "namespace": null,
                            "name": "Text",
                            "description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
                            "class": "[EUPH-code: 7322]",
                            "unit": null,
                            "created_at": null,
                            "updated_at": "2024-09-14T11:17:02.000000Z"
                        },
                        "unit": null,
                        "datatype": null,
                        "order": 0,
                        "created_at": "2023-12-13T16:41:47.000000Z",
                        "updated_at": "2024-01-26T18:23:53.000000Z"
                    },
                    {
                        "id": 1215,
                        "name": "cibac",
                        "description": "Code of the Collaborative International Pesticides Analytical Council.",
                        "descriptor": {
                            "id": 314,
                            "uid": "0.0.DCMLN314",
                            "namespace": null,
                            "name": "DecimalNumber",
                            "description": "> Any of the rational or irrational numbers.",
                            "class": "[EUPH-code: 7325]",
                            "unit": null,
                            "created_at": null,
                            "updated_at": "2025-01-12T10:31:26.000000Z"
                        },
                        "unit": null,
                        "datatype": null,
                        "order": 0,
                        "created_at": "2023-12-13T16:41:47.000000Z",
                        "updated_at": "2024-01-26T18:23:53.000000Z"
                    }
                ],
                "data_files": [
                    {
                        "id": 280,
                        "name": "euph_000046_eu-regulation-2017-269_table_harmonised_cibac.csv",
                        "description": null,
                        "status": "analyzed",
                        "type": "csv",
                        "mimetype": "text/csv",
                        "file_size": 9522,
                        "download_count": 0,
                        "created_at": "2023-12-13T16:41:46.000000Z",
                        "updated_at": "2023-12-13T16:41:47.000000Z"
                    }
                ],
                "supplemental_files": [],
                "created_at": "2023-12-13T16:41:32.000000Z",
                "updated_at": "2024-01-25T09:26:58.000000Z"
            },
            {
                "id": 151,
                "uid": "RGLTN80.HRMNS151.0",
                "name": "Harmonised classification",
                "description": "The table contains a summary of the table in annex III of Commission Regulation (EU) 2017/269 of 16 February 2017 amending Regulation (EC) No 1185/2009 of the European Parliament and of the Council concerning statistics on pesticides, as regards the list of active substances.",
                "featured_image": null,
                "structure": null,
                "preparation": null,
                "changes": null,
                "unresolved": null,
                "additional_information": null,
                "type": "file",
                "licence": null,
                "columns": [
                    {
                        "id": 1219,
                        "name": "id",
                        "description": "Identifier of the record.",
                        "descriptor": {
                            "id": 315,
                            "uid": "0.0.TEXTA315",
                            "namespace": null,
                            "name": "Text",
                            "description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
                            "class": "[EUPH-code: 7322]",
                            "unit": null,
                            "created_at": null,
                            "updated_at": "2024-09-14T11:17:02.000000Z"
                        },
                        "unit": null,
                        "datatype": null,
                        "order": 0,
                        "created_at": "2023-12-15T14:58:18.000000Z",
                        "updated_at": "2024-01-26T18:23:54.000000Z"
                    },
                    {
                        "id": 1220,
                        "name": "code",
                        "description": "Code of the harmonised classification of substances",
                        "descriptor": {
                            "id": 315,
                            "uid": "0.0.TEXTA315",
                            "namespace": null,
                            "name": "Text",
                            "description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
                            "class": "[EUPH-code: 7322]",
                            "unit": null,
                            "created_at": null,
                            "updated_at": "2024-09-14T11:17:02.000000Z"
                        },
                        "unit": null,
                        "datatype": null,
                        "order": 0,
                        "created_at": "2023-12-15T14:58:18.000000Z",
                        "updated_at": "2024-01-26T18:23:54.000000Z"
                    },
                    {
                        "id": 1221,
                        "name": "description",
                        "description": "Name of of the item.",
                        "descriptor": {
                            "id": 315,
                            "uid": "0.0.TEXTA315",
                            "namespace": null,
                            "name": "Text",
                            "description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
                            "class": "[EUPH-code: 7322]",
                            "unit": null,
                            "created_at": null,
                            "updated_at": "2024-09-14T11:17:02.000000Z"
                        },
                        "unit": null,
                        "datatype": null,
                        "order": 0,
                        "created_at": "2023-12-15T14:58:18.000000Z",
                        "updated_at": "2024-01-26T18:23:54.000000Z"
                    },
                    {
                        "id": 1222,
                        "name": "aggregate",
                        "description": "Aggregate level of the reported item (majorgroups: highest aggregation level, major groups in the harmonised classification of substances; category: second aggregation level, categories of products; class: third aggregation level, chemical classes; substance: fourth aggregation level, active substances in plant protection products).",
                        "descriptor": {
                            "id": 315,
                            "uid": "0.0.TEXTA315",
                            "namespace": null,
                            "name": "Text",
                            "description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
                            "class": "[EUPH-code: 7322]",
                            "unit": null,
                            "created_at": null,
                            "updated_at": "2024-09-14T11:17:02.000000Z"
                        },
                        "unit": null,
                        "datatype": null,
                        "order": 0,
                        "created_at": "2023-12-15T14:58:18.000000Z",
                        "updated_at": "2024-01-26T18:23:54.000000Z"
                    },
                    {
                        "id": 1223,
                        "name": "euph_code",
                        "description": "Unique identifier of a class on the EU Pollinator Hub.",
                        "descriptor": {
                            "id": 313,
                            "uid": "0.0.NTGER313",
                            "namespace": null,
                            "name": "Integer",
                            "description": "> A number with no fractional part, including the negative and positive numbers as well as zero.",
                            "class": "[EUPH-code: 7324]",
                            "unit": null,
                            "created_at": null,
                            "updated_at": "2024-09-14T11:14:52.000000Z"
                        },
                        "unit": null,
                        "datatype": null,
                        "order": 0,
                        "created_at": "2023-12-15T14:58:18.000000Z",
                        "updated_at": "2024-01-26T18:23:54.000000Z"
                    },
                    {
                        "id": 1224,
                        "name": "parent",
                        "description": "Superior aggregate level of the reported item.",
                        "descriptor": {
                            "id": 315,
                            "uid": "0.0.TEXTA315",
                            "namespace": null,
                            "name": "Text",
                            "description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
                            "class": "[EUPH-code: 7322]",
                            "unit": null,
                            "created_at": null,
                            "updated_at": "2024-09-14T11:17:02.000000Z"
                        },
                        "unit": null,
                        "datatype": null,
                        "order": 0,
                        "created_at": "2023-12-15T14:58:18.000000Z",
                        "updated_at": "2024-01-26T18:23:54.000000Z"
                    }
                ],
                "data_files": [
                    {
                        "id": 285,
                        "name": "euph_000046_eu-regulation-2017-269_table_harmonised_classification.csv",
                        "description": null,
                        "status": "analyzed",
                        "type": "csv",
                        "mimetype": "text/csv",
                        "file_size": 45132,
                        "download_count": 0,
                        "created_at": "2023-12-15T14:58:18.000000Z",
                        "updated_at": "2023-12-15T14:58:18.000000Z"
                    }
                ],
                "supplemental_files": [],
                "created_at": "2023-12-15T14:58:05.000000Z",
                "updated_at": "2024-01-25T09:26:58.000000Z"
            }
        ],
        "descriptors": [],
        "published_at": "2023-12-13T23:00:00.000000Z",
        "created_at": "2023-12-13T16:37:54.000000Z",
        "updated_at": "2025-02-09T09:41:13.000000Z"
    }
}
 

Request   

GET api/v1/discovery/datasets/{dataset_uid}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

dataset_uid   string  optional  

The dataset UID. Example: RGLTN80.0.0

Response

Response Fields

data   object[]   

A list of metadata associated with the requested dataset.

uid   string   

The unique identifier used to identify the entity within the platform.

name   string   

The actual name of the dataset.

long_name   string   

The long version of the name of the dataset.

description   string   

Abstract about the dataset. Uses Markdown for styling.

data_overview   string   

Concise information (less than 200 words) about: e.g. provider of the data (who?); origin of the data and the subject area covered by the dataset (what?); geographical origin of the data (where?); time period covered by the dataset (when?). Uses Markdown for styling.

data_value   string   

Concise information (less than 200 words) about: e.g. reason for collecting the data; possible benefits resulting from the collection of the data (why?). Uses Markdown for styling.

data_description   string   

Concise description (less than 200 words) of the dataset metrics: e.g. number of files; categories of data; size of the datasets in bytes. Uses Markdown for styling.

data_application   string   

A concise summary (less than 200 words) of possible applications for which the data could be used, scientific or technical questions or other issues that could be addressed (for what?). Uses Markdown for styling.

data_issues   string   

A list of unresolved issues and quality concerns. Uses Markdown for styling.

introduction   string   

A longer description about the dataset.Uses Markdown for styling.

acquisition   string   

Description of or a reference to material and methods used to acquire the data in the dataset and a detailed list of terms under which the data has been made available (licensing).Uses Markdown for styling.

preparation   string   

Detailed description of material (product, model) and methods (provide references if possible) used to prepare the dataset. Uses Markdown for styling.

validation   string   

Detailed description of material (product, model) and methods (provide references if possible) used to validate the dataset for the purpose of data quality assessment. Uses Markdown for styling.

analysis   string   

Detailed description of material (product, model) and methods (provide references if possible) used to analyse the dataset for the purpose of data quality assessment. Uses Markdown for styling.

status   string   

The status of the dataset. The list of available status are the following: draft, pending, reject, reviewing, pending-peer-rev, peer-reviewing, publish, publish-with-pw, trash, hidden

public   boolean   

Value of 1 means that the data of this dataset are publicly accessible.

licence      

array|null The licence information of this entity.

name   string   

The name of the licence.

abbreviation   string   

The short name of the licence.

description   string   

The description of the licence.

uid   string   

The unique identifier of the licence.

url_summary   string|null   

Url to external description of this licence.

url_legal   string|null   

Url to external legal definition of this licence.

image_url   string|null   

Url to licence image representation.

contact   object[]   

A list of contact points for the entity.

type   string   

The type of the contact.

value   string   

The actual value of the contact, for

entities   string[]   

Array containing the uid of the entities of this dataset.

*   string   

The Uid of the entity.

contributors   string[]   

Array containing the uid of the contributors of this dataset.

*   string   

The Uid of the contributor.

parts   string[]   

An array containing all related dataset tables. Field is hidden for non-public datasets.

*   object   
uid   string   

The unique identifier used to identify the table within the platform.

name   string   

Name of the table.

description   string   

Description of the table. Uses Markdown for styling.

structure   string   

An unordered list of potential links between columns of the same file, of different files of the same dataset or of different files of different datasets as follows: Column [dataset].[file].[column] links on [dataset].[file].[column]. Uses Markdown for styling.

preparation   string   

It contains an unordered list of all changes made in the preparatory file described in the parent section according to Directory-006 (Dataset preparation). Uses Markdown for styling.

changes   string   

It contains an unordered list of all changes made in the data after integration of the file described in the parent section into the EUPH according to Directory-006 (Dataset preparation). Uses Markdown for styling.

unresolved   string   

It contains an unordered list of all unresolved issues in the file of the parent section requiring intervention by the data provider according to Directory-007 (Data profiling). Uses Markdown for styling.

created_at   string   

The date and time the table was created.

updated_at   string   

The date and time the table was last updated.

id   integer   

Numeric identifier of the table.

descriptors   string[]   

An array of all descriptors, used to integrate this dataset. Field is hidden for non-public datasets.

*   object   
uid   string   

The unique identifier used to identify the descriptor within the platform.

namespace   string|null   

The namespace this descriptor belongs to.

name   string   

Name of the descriptor.

description   string|null   

A short, concise description of the descriptor. If a class is assigned to descriptor, this field contains the accepted definition of the related class. Uses Markdown for styling.

notes   string|null   

Any additional notes attached to the descriptor. Uses Markdown for styling.

examples   string|null   

A list of examples, how the data may appear. Uses Markdown for styling.

class   string|null   

An optional class, related to this descriptor.

unit   string|null   

The unit data is saved in. May not be set.

deprecated   boolean   

Whether this descriptor is deprecated or not. Deprecated descriptors can not be used to import new data.

created_at   string   

The date and time the table was created.

updated_at   string   

The date and time the table was last updated.

published_at   string|null   

The date and time the dataset was published.

created_at   string   

The date and time the dataset was created.

updated_at   string   

The date and time the dataset was last updated.

List data

requires authentication

Retrieves data based on dataset table unique identifier.

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?limit=3" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'limit' => '3',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0"
);

const params = {
    "limit": "3",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0'
params = {
  'limit': '3',
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 56
access-control-allow-origin: *
 

{
    "current_page": 1,
    "data": [
        {
            "id": 5144238,
            "timestamp": null,
            "data": [
                {
                    "descriptor": "0.0.LPHCN4",
                    "column": "alpha2code",
                    "column_id": 28,
                    "value": "AL",
                    "unit": null
                },
                {
                    "descriptor": "NUTSA3.RNITS37.NTSLV41",
                    "column": "nuts3",
                    "column_id": 33,
                    "value": "Qarks",
                    "unit": null
                }
            ]
        },
        {
            "id": 5144239,
            "timestamp": null,
            "data": [
                {
                    "descriptor": "0.0.LPHCN4",
                    "column": "alpha2code",
                    "column_id": 28,
                    "value": "AT",
                    "unit": null
                },
                {
                    "descriptor": "NUTSA3.RNITS37.NTSLV37",
                    "column": "nuts1",
                    "column_id": 29,
                    "value": "Gruppen von \nBundesländern",
                    "unit": null
                },
                {
                    "descriptor": "NUTSA3.RNITS37.NTSLV39",
                    "column": "nuts2",
                    "column_id": 31,
                    "value": "Bundesländer",
                    "unit": null
                },
                {
                    "descriptor": "NUTSA3.RNITS37.NTSLV41",
                    "column": "nuts3",
                    "column_id": 33,
                    "value": "Gruppen von Gemeinden",
                    "unit": null
                },
                {
                    "descriptor": "0.0.TEXTA315",
                    "column": "lau",
                    "column_id": 35,
                    "value": "Gemeinden",
                    "unit": null
                }
            ]
        },
        {
            "id": 5144240,
            "timestamp": null,
            "data": [
                {
                    "descriptor": "0.0.LPHCN4",
                    "column": "alpha2code",
                    "column_id": 28,
                    "value": "BE",
                    "unit": null
                },
                {
                    "descriptor": "NUTSA3.RNITS37.NTSLV37",
                    "column": "nuts1",
                    "column_id": 29,
                    "value": "Gewesten / \nRégions",
                    "unit": null
                },
                {
                    "descriptor": "NUTSA3.RNITS37.NTSLV39",
                    "column": "nuts2",
                    "column_id": 31,
                    "value": "Provincies / Provinces",
                    "unit": null
                },
                {
                    "descriptor": "NUTSA3.RNITS37.NTSLV41",
                    "column": "nuts3",
                    "column_id": 33,
                    "value": "Arrondisse-menten / Arrondisse-ments",
                    "unit": null
                },
                {
                    "descriptor": "0.0.TEXTA315",
                    "column": "lau",
                    "column_id": 35,
                    "value": "Gemeenten / Communes",
                    "unit": null
                }
            ]
        }
    ],
    "first_page_url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=1",
    "from": 1,
    "last_page": 13,
    "last_page_url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=13",
    "links": [
        {
            "url": null,
            "label": "« Previous",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=1",
            "label": "1",
            "active": true
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=2",
            "label": "2",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=3",
            "label": "3",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=4",
            "label": "4",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=5",
            "label": "5",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=6",
            "label": "6",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=7",
            "label": "7",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=8",
            "label": "8",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=9",
            "label": "9",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=10",
            "label": "10",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=11",
            "label": "11",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=12",
            "label": "12",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=13",
            "label": "13",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=2",
            "label": "Next »",
            "active": false
        }
    ],
    "next_page_url": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0?page=2",
    "path": "https://app.pollinatorhub.eu/api/v1/discovery/data/NUTSA3.RNITS37.0",
    "per_page": 3,
    "prev_page_url": null,
    "to": 3,
    "total": 37
}
 

Request   

GET api/v1/discovery/data/{dataset_part_uid}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

dataset_part_uid   string  optional  

The unique identifier from a dataset table. Example: NUTSA3.RNITS37.0

Query Parameters

page   integer  optional  

Load specified page to view the results. Default: 1

limit   integer  optional  

Set the amount of results the API returns. Up to 1000. Default: 100 Example: 3

Response

Response Fields

records   object[]   

List of Records.

*   object   
id   string   

The record id, used to identify it in EUPH database.

timestamp   string   

Timestamp this record was recorded at.

data   object[]   

List of data contained within the Record.

*   object   
column   string   

The name of the column, the value was imported from.

column_id   int|null   

The internal id of the column.

descriptor   string   

The UID of the descriptor this datum represents.

value      

The value of the datum.

unit   string|null   

The UID of the Unit, this datum is related to. Can be null.

Entities

A group of routes used to manage Entities (Data providers), related to authenticated user.

List Entities

requires authentication

Retrieve a list of all entities authenticated user has access to.

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/entities?page=1&limit=3" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/entities';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'page' => '1',
            'limit' => '3',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/entities"
);

const params = {
    "page": "1",
    "limit": "3",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/entities'
params = {
  'page': '1',
  'limit': '3',
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 59
access-control-allow-origin: *
 

{
    "current_page": 1,
    "data": [
        {
            "id": 13,
            "uid": "boe",
            "name": "Biene Österreich – Imkereidachverband",
            "type": "person",
            "abbreviation": " BÖ",
            "created_at": "2023-10-05T10:02:30.000000Z",
            "updated_at": "2023-11-21T13:58:41.000000Z"
        },
        {
            "id": 3,
            "uid": "euph",
            "name": "EU Pollinator Hub",
            "type": "legal-entity",
            "abbreviation": "EUPH",
            "created_at": "2023-10-05T10:02:30.000000Z",
            "updated_at": "2024-06-04T12:59:02.000000Z"
        },
        {
            "id": 14,
            "uid": "efsa",
            "name": "European Food Safety Authority",
            "type": "person",
            "abbreviation": "EFSA",
            "created_at": "2023-10-05T10:02:30.000000Z",
            "updated_at": "2023-10-26T17:37:58.000000Z"
        }
    ],
    "first_page_url": "https://app.pollinatorhub.eu/api/v1/entities?page=1",
    "from": 1,
    "last_page": 2,
    "last_page_url": "https://app.pollinatorhub.eu/api/v1/entities?page=2",
    "links": [
        {
            "url": null,
            "label": "« Previous",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/entities?page=1",
            "label": "1",
            "active": true
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/entities?page=2",
            "label": "2",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/entities?page=2",
            "label": "Next »",
            "active": false
        }
    ],
    "next_page_url": "https://app.pollinatorhub.eu/api/v1/entities?page=2",
    "path": "https://app.pollinatorhub.eu/api/v1/entities",
    "per_page": 3,
    "prev_page_url": null,
    "to": 3,
    "total": 4
}
 

Request   

GET api/v1/entities

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

Query Parameters

page   integer  optional  

Load specified page to view the results. Default: 1 Example: 1

limit   integer  optional  

Set the amount of results the API returns. Up to 1000. Default: 100 Example: 3

Response

Response Fields

data   string[]   

A list of entities available to the User.

*   object   
id   integer   

Numeric identifier of the entity.

uid   string   

The unique identifier used to identify the entity within the platform.

name   string   

A descriptive name of the entity.

abbreviation   string   

Abbreviation or short name of the entity.

type   string   

Type of the Entity. Can be 'person' or 'legal-entity'.

created_at   string   

The date and time the entity was created.

updated_at   string   

The date and time the entity was last updated.

Create Entity

requires authentication

Create a new entity to be used and interact with.

Example request:
curl --request POST \
    "https://app.pollinatorhub.eu/api/v1/entities" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"European Food Safety Authority\",
    \"abbreviation\": \"EFSA\",
    \"country_id\": \"IT\",
    \"type\": \"legal-entity\",
    \"contact\": [
        {
            \"type\": \"email\",
            \"value\": \"example@pollinatorhub.eu\"
        }
    ]
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/entities';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'European Food Safety Authority',
            'abbreviation' => 'EFSA',
            'country_id' => 'IT',
            'type' => 'legal-entity',
            'contact' => [
                [
                    'type' => 'email',
                    'value' => 'example@pollinatorhub.eu',
                ],
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/entities"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "European Food Safety Authority",
    "abbreviation": "EFSA",
    "country_id": "IT",
    "type": "legal-entity",
    "contact": [
        {
            "type": "email",
            "value": "example@pollinatorhub.eu"
        }
    ]
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/entities'
payload = {
    "name": "European Food Safety Authority",
    "abbreviation": "EFSA",
    "country_id": "IT",
    "type": "legal-entity",
    "contact": [
        {
            "type": "email",
            "value": "example@pollinatorhub.eu"
        }
    ]
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Request   

POST api/v1/entities

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

name   string   

A descriptive name of the legal entity or person. Must not be greater than 250 characters. Must be at least 4 characters. Example: European Food Safety Authority

abbreviation   string   

Abbreviation or short name of the legal entity or person. Must not be greater than 10 characters. Example: EFSA

address   string  optional  

Full address of the entity. It is not required for private persons. This field is required unless registry_number is in null. Must not be greater than 15000 characters.

registry_number   string  optional  

A public unique identifier used to identify a legal entity. Can be empty for private persons. Must not be greater than 20 characters. Must be at least 5 characters.

description   string  optional  

A longer description about the entity. Accepts Markdown for styling. Must not be greater than 15000 characters.

country_id   string   

A two-letter ISO 3166 code that represents a country name. Must be 2 characters. Example: IT

Must be one of:
  • AC
  • AD
  • AE
  • AF
  • AG
  • AI
  • AI
  • AL
  • AM
  • AN
  • AO
  • AQ
  • AR
  • AS
  • AT
  • AU
  • AW
  • AX
  • AZ
  • BA
  • BB
  • BD
  • BE
  • BF
  • BG
  • BH
  • BI
  • BJ
  • BL
  • BM
  • BN
  • BO
  • BQ
  • BQ
  • BR
  • BS
  • BT
  • BU
  • BV
  • BW
  • BY
  • BY
  • BZ
  • CA
  • CC
  • CD
  • CF
  • CG
  • CH
  • CI
  • CK
  • CL
  • CM
  • CN
  • CO
  • CP
  • CQ
  • CR
  • CS
  • CS
  • CT
  • CU
  • CV
  • CW
  • CX
  • CY
  • CZ
  • DD
  • DE
  • DG
  • DJ
  • DK
  • DM
  • DO
  • DY
  • DZ
  • EA
  • EC
  • EE
  • EG
  • EH
  • ER
  • ES
  • ET
  • EU
  • EZ
  • FI
  • FJ
  • FK
  • FM
  • FO
  • FQ
  • FR
  • FX
  • GA
  • GB
  • GD
  • GE
  • GE
  • GF
  • GG
  • GH
  • GI
  • GL
  • GM
  • GN
  • GP
  • GQ
  • GR
  • GS
  • GT
  • GU
  • GW
  • GY
  • HK
  • HM
  • HN
  • HR
  • HT
  • HU
  • HV
  • IC
  • ID
  • IE
  • IL
  • IM
  • IN
  • IO
  • IQ
  • IR
  • IS
  • IT
  • JE
  • JM
  • JO
  • JP
  • JT
  • KE
  • KG
  • KH
  • KI
  • KM
  • KN
  • KP
  • KR
  • KW
  • KY
  • KZ
  • LA
  • LB
  • LC
  • LI
  • LK
  • LR
  • LS
  • LT
  • LU
  • LV
  • LY
  • MA
  • MC
  • MD
  • ME
  • MF
  • MG
  • MH
  • MI
  • MK
  • ML
  • MM
  • MN
  • MO
  • MP
  • MQ
  • MR
  • MS
  • MT
  • MU
  • MV
  • MW
  • MX
  • MY
  • MZ
  • NA
  • NC
  • NE
  • NF
  • NG
  • NH
  • NI
  • NL
  • NO
  • NP
  • NQ
  • NR
  • NT
  • NU
  • NZ
  • OM
  • PA
  • PC
  • PE
  • PF
  • PG
  • PH
  • PK
  • PL
  • PM
  • PN
  • PR
  • PS
  • PT
  • PU
  • PW
  • PY
  • PZ
  • QA
  • RE
  • RH
  • RO
  • RS
  • RU
  • RW
  • SA
  • SB
  • SC
  • SD
  • SE
  • SG
  • SH
  • SI
  • SJ
  • SK
  • SK
  • SL
  • SM
  • SN
  • SO
  • SR
  • SS
  • ST
  • SU
  • SV
  • SX
  • SY
  • SZ
  • TA
  • TC
  • TD
  • TF
  • TG
  • TH
  • TJ
  • TK
  • TL
  • TM
  • TN
  • TO
  • TP
  • TR
  • TT
  • TV
  • TW
  • TZ
  • UA
  • UG
  • UK
  • UM
  • UN
  • US
  • UY
  • UZ
  • VA
  • VC
  • VD
  • VE
  • VG
  • VI
  • VN
  • VU
  • WF
  • WK
  • WS
  • YD
  • YE
  • YT
  • YU
  • ZA
  • ZM
  • ZR
  • ZW
contact   object[]  optional  

A list of contact points for the entity.

type   string   

The type of the contact. Should be one of: email, url, phone, address, url-facebook, url-twitter, url-linkedin, url-youtube, url-vimeo, url-research-gate, url-orcid. Example: email

value   string   

The actual value of the contact based on supplied type, for example email address, url or other. Example: example@pollinatorhub.eu

type   string   

Example: legal-entity

Must be one of:
  • person
  • legal-entity

Show Entity

requires authentication

Displays a single entity based on unique identifier. Only allows viewing entities that the user has access to.

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/entities/3" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/entities/3';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/entities/3"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/entities/3'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 58
access-control-allow-origin: *
 

{
    "data": {
        "id": 3,
        "uid": "euph",
        "name": "EU Pollinator Hub",
        "type": "legal-entity",
        "abbreviation": "EUPH",
        "registry_number": null,
        "description": "The EU Pollinator Hub (EUPH) is a data hub related to pollinators, which is provided by the European Food Safety Authority (EFSA).",
        "address": null,
        "featured_image": "https://app.pollinatorhub.eu/storage/entities/01HZHN8AQYJDJ2SV1Z8X3XS661.jpg",
        "contacts": [
            {
                "type": "url-linkedin",
                "value": "https://www.linkedin.com/company/beelife-european-beekeeping-coordination/"
            },
            {
                "type": "url",
                "value": "https://pollinatorhub.eu"
            }
        ],
        "country": {
            "iso-3166:shortLowercaseNameOfCountry": "Belgium",
            "full_name": "the Kingdom of Belgium",
            "unsd:m49Area": "56",
            "iso-3166:alpha-2CountryCode": "BE",
            "iso-3166:alpha-3CountryCode": "BEL"
        },
        "created_at": "2023-10-05T10:02:30.000000Z",
        "updated_at": "2024-06-04T12:59:02.000000Z"
    }
}
 

Request   

GET api/v1/entities/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The unique identifier used to identify the Entity within the platform. Example: 3

Response

Response Fields

data   string[]   

A list of entities available to the User.

id   integer   

Numeric identifier of the entity.

name   string   

A descriptive name of the entity.

uid   string   

The unique identifier used to identify the Entity within the platform.

contact   object[]   

A list of contact points for the entity.

type   string   

The type of the contact.

value   string   

The actual value of the contact, for example email address, url or other.

abbreviation   string|null   

Abbreviation or short name of the entity.

registry_number   string|null   

A public unique identifier used to identify a legal entity. Can be empty for private persons.

description   string|null   

A longer description about the entity. Uses Markdown for styling.

address   string|null   

Full address of the entity. Can be empty for private persons.

featured_image   string|null   

Url to the featured image.

country   object   

Country the entity resides in.

full_name   string   

Full name of the country.

iso-3166:shortLowercaseNameOfCountry   string   

Short name, written in lower case letters, of the country.

unsd:m49Area   string   

Numeric code of the country according to ISO-3166 standard.

iso-3166:alpha-2CountryCode   string   

A two-letter code that represents a country name, recommended as general purpose code.

iso-3166:alpha-3CountryCode   string   

A three-letter code that represents a country name.

type   string   

Type of the Entity. Can be 'person' or 'legal-entity'.

created_at   string   

The date and time the entity was created.

updated_at   string   

The date and time the entity was last updated.

Update Entity

requires authentication

Update entity metadata.

Example request:
curl --request PUT \
    "https://app.pollinatorhub.eu/api/v1/entities/beatae" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"European Food Safety Authority\",
    \"abbreviation\": \"EFSA\",
    \"country_id\": \"IT\",
    \"contact\": [
        {
            \"type\": \"email\",
            \"value\": \"example@pollinatorhub.eu\"
        }
    ]
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/entities/beatae';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'European Food Safety Authority',
            'abbreviation' => 'EFSA',
            'country_id' => 'IT',
            'contact' => [
                [
                    'type' => 'email',
                    'value' => 'example@pollinatorhub.eu',
                ],
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/entities/beatae"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "European Food Safety Authority",
    "abbreviation": "EFSA",
    "country_id": "IT",
    "contact": [
        {
            "type": "email",
            "value": "example@pollinatorhub.eu"
        }
    ]
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/entities/beatae'
payload = {
    "name": "European Food Safety Authority",
    "abbreviation": "EFSA",
    "country_id": "IT",
    "contact": [
        {
            "type": "email",
            "value": "example@pollinatorhub.eu"
        }
    ]
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('PUT', url, headers=headers, json=payload)
response.json()

Request   

PUT api/v1/entities/{id}

PATCH api/v1/entities/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the entity. Example: beatae

Body Parameters

name   string   

A descriptive name of the legal entity or person. Must not be greater than 250 characters. Must be at least 4 characters. Example: European Food Safety Authority

abbreviation   string   

Abbreviation or short name of the legal entity or person. Must not be greater than 20 characters. Example: EFSA

address   string  optional  

Full address of the entity. It is not required for private persons. This field is required unless registry_number is in null. Must not be greater than 15000 characters. Must be at least 10 characters.

registry_number   string  optional  

A public unique identifier used to identify a legal entity. Can be empty for private persons. Must not be greater than 20 characters. Must be at least 5 characters.

description   string  optional  

A longer description about the entity. Accepts Markdown for styling. Must not be greater than 15000 characters.

country_id   string   

A two-letter ISO 3166 code that represents a country name. Must be 2 characters. Example: IT

Must be one of:
  • AC
  • AD
  • AE
  • AF
  • AG
  • AI
  • AI
  • AL
  • AM
  • AN
  • AO
  • AQ
  • AR
  • AS
  • AT
  • AU
  • AW
  • AX
  • AZ
  • BA
  • BB
  • BD
  • BE
  • BF
  • BG
  • BH
  • BI
  • BJ
  • BL
  • BM
  • BN
  • BO
  • BQ
  • BQ
  • BR
  • BS
  • BT
  • BU
  • BV
  • BW
  • BY
  • BY
  • BZ
  • CA
  • CC
  • CD
  • CF
  • CG
  • CH
  • CI
  • CK
  • CL
  • CM
  • CN
  • CO
  • CP
  • CQ
  • CR
  • CS
  • CS
  • CT
  • CU
  • CV
  • CW
  • CX
  • CY
  • CZ
  • DD
  • DE
  • DG
  • DJ
  • DK
  • DM
  • DO
  • DY
  • DZ
  • EA
  • EC
  • EE
  • EG
  • EH
  • ER
  • ES
  • ET
  • EU
  • EZ
  • FI
  • FJ
  • FK
  • FM
  • FO
  • FQ
  • FR
  • FX
  • GA
  • GB
  • GD
  • GE
  • GE
  • GF
  • GG
  • GH
  • GI
  • GL
  • GM
  • GN
  • GP
  • GQ
  • GR
  • GS
  • GT
  • GU
  • GW
  • GY
  • HK
  • HM
  • HN
  • HR
  • HT
  • HU
  • HV
  • IC
  • ID
  • IE
  • IL
  • IM
  • IN
  • IO
  • IQ
  • IR
  • IS
  • IT
  • JE
  • JM
  • JO
  • JP
  • JT
  • KE
  • KG
  • KH
  • KI
  • KM
  • KN
  • KP
  • KR
  • KW
  • KY
  • KZ
  • LA
  • LB
  • LC
  • LI
  • LK
  • LR
  • LS
  • LT
  • LU
  • LV
  • LY
  • MA
  • MC
  • MD
  • ME
  • MF
  • MG
  • MH
  • MI
  • MK
  • ML
  • MM
  • MN
  • MO
  • MP
  • MQ
  • MR
  • MS
  • MT
  • MU
  • MV
  • MW
  • MX
  • MY
  • MZ
  • NA
  • NC
  • NE
  • NF
  • NG
  • NH
  • NI
  • NL
  • NO
  • NP
  • NQ
  • NR
  • NT
  • NU
  • NZ
  • OM
  • PA
  • PC
  • PE
  • PF
  • PG
  • PH
  • PK
  • PL
  • PM
  • PN
  • PR
  • PS
  • PT
  • PU
  • PW
  • PY
  • PZ
  • QA
  • RE
  • RH
  • RO
  • RS
  • RU
  • RW
  • SA
  • SB
  • SC
  • SD
  • SE
  • SG
  • SH
  • SI
  • SJ
  • SK
  • SK
  • SL
  • SM
  • SN
  • SO
  • SR
  • SS
  • ST
  • SU
  • SV
  • SX
  • SY
  • SZ
  • TA
  • TC
  • TD
  • TF
  • TG
  • TH
  • TJ
  • TK
  • TL
  • TM
  • TN
  • TO
  • TP
  • TR
  • TT
  • TV
  • TW
  • TZ
  • UA
  • UG
  • UK
  • UM
  • UN
  • US
  • UY
  • UZ
  • VA
  • VC
  • VD
  • VE
  • VG
  • VI
  • VN
  • VU
  • WF
  • WK
  • WS
  • YD
  • YE
  • YT
  • YU
  • ZA
  • ZM
  • ZR
  • ZW
contact   object[]  optional  

A list of contact points for the entity.

type   string   

The type of the contact. Should be one of: email, url, phone, address, url-facebook, url-twitter, url-linkedin, url-youtube, url-vimeo, url-research-gate, url-orcid. Example: email

value   string   

The actual value of the contact based on supplied type, for example email address, url or other. Example: example@pollinatorhub.eu

Delete entity

requires authentication

Delete selected entity. Note, an entity with associated datasets can not be deleted.

Example request:
curl --request DELETE \
    "https://app.pollinatorhub.eu/api/v1/entities/ipsa" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/entities/ipsa';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/entities/ipsa"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/entities/ipsa'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('DELETE', url, headers=headers)
response.json()

Request   

DELETE api/v1/entities/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   string   

The ID of the entity. Example: ipsa

Datasets

This route will allow modifications to the meta-data for the Datasets. It includes basic information like name, description and contact information. It is owned by one or more entities. It directly owns one or more Dataset Parts. It is identified by UID which is created during the data entity creation procedure.

List datasets

requires authentication

Display a listing of the Datasets, the User has access to.

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/datasets?entity=euph&page=1&limit=3" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'entity' => 'euph',
            'page' => '1',
            'limit' => '3',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/datasets"
);

const params = {
    "entity": "euph",
    "page": "1",
    "limit": "3",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/datasets'
params = {
  'entity': 'euph',
  'page': '1',
  'limit': '3',
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 57
access-control-allow-origin: *
 

{
    "current_page": 1,
    "data": [
        {
            "id": 6,
            "uid": "HNYPR6.0.0",
            "name": "Honey production Austria",
            "long_name": "Honey production in Austria",
            "description": "The dataset contains anonymised total annual honey yields of test colonies from the performance testing scheme of the Austrian honey bee breeding program. The locations of apiaries were aggregated by NUTS level 1 and HPG.",
            "featured_image": null,
            "status": "publish",
            "public": true,
            "licence": "CC BY-NC-SA 4.0",
            "published_at": "2023-04-16T22:00:00.000000Z",
            "created_at": "2023-01-26T18:18:06.000000Z",
            "updated_at": "2024-01-25T09:26:57.000000Z"
        },
        {
            "id": 8,
            "uid": "BKPNG8.0.0",
            "name": "Beekeeping Austria",
            "long_name": "Collection of data related to honey bees in Austria.",
            "description": "This dataset is a collection of data related to honey bees (*Apis mellifera* L.) in Austria.",
            "featured_image": null,
            "status": "publish",
            "public": true,
            "licence": "CC BY-NC-SA 4.0",
            "published_at": "2023-11-30T23:00:00.000000Z",
            "created_at": "2022-04-27T07:15:00.000000Z",
            "updated_at": "2025-04-18T09:26:56.000000Z"
        },
        {
            "id": 14,
            "uid": "VTCSS14.0.0",
            "name": "Vetcases",
            "long_name": "Reports of notifiable diseases reported for Apis mellifera",
            "description": "This dataset contains data from various sources on the outbreak of notifiable diseases reported for honey bees (*Apis mellifera*) in Belgium and Austria from 2000 to 2022.",
            "featured_image": "https://app.pollinatorhub.eu/storage/providers/01HHF30JC0SSJRQESPPWNJG3F5.png",
            "status": "publish",
            "public": true,
            "licence": "CC BY-NC-SA 4.0",
            "published_at": "2023-06-12T22:00:00.000000Z",
            "created_at": "2023-02-08T15:11:52.000000Z",
            "updated_at": "2025-04-18T09:26:56.000000Z"
        }
    ],
    "first_page_url": "https://app.pollinatorhub.eu/api/v1/datasets?page=1",
    "from": 1,
    "last_page": 14,
    "last_page_url": "https://app.pollinatorhub.eu/api/v1/datasets?page=14",
    "links": [
        {
            "url": null,
            "label": "« Previous",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=1",
            "label": "1",
            "active": true
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=2",
            "label": "2",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=3",
            "label": "3",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=4",
            "label": "4",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=5",
            "label": "5",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=6",
            "label": "6",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=7",
            "label": "7",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=8",
            "label": "8",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=9",
            "label": "9",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=10",
            "label": "10",
            "active": false
        },
        {
            "url": null,
            "label": "...",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=13",
            "label": "13",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=14",
            "label": "14",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/datasets?page=2",
            "label": "Next »",
            "active": false
        }
    ],
    "next_page_url": "https://app.pollinatorhub.eu/api/v1/datasets?page=2",
    "path": "https://app.pollinatorhub.eu/api/v1/datasets",
    "per_page": 3,
    "prev_page_url": null,
    "to": 3,
    "total": 40
}
 

Request   

GET api/v1/datasets

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

Query Parameters

entity   string  optional  

Filter datasets by Entity uid. Example: euph

page   integer  optional  

Load specified page to view the results. Default: 1 Example: 1

limit   integer  optional  

Set the amount of results the API returns. Up to 1000. Default: 100 Example: 3

Response

Response Fields

data   object[]   

A list of Datasets available to the User.

*   object   
id   integer   

Numeric identifier of the dataset.

name   string   

The actual name of the dataset.

long_name   string   

The long version of the name of the dataset.

uid   string   

The unique identifier used to identify the entity within the platform.

description   string   

Dataset abstract. Uses Markdown for styling.

featured_image   string|null   

URL to uploaded image representing this dataset.

status   string   

The status of the dataset. The list of available status are the following: draft, pending, reject, reviewing, pending-peer-rev, peer-reviewing, publish, publish-with-pw, trash, hidden

public   boolean   

1 means that the data of this dataset are public.

licence   string|null   

The uid of the licence of this entity.

published_at   string|null   

The date and time the dataset was published.

created_at   string   

The date and time the dataset was created.

updated_at   string   

The date and time the dataset was last updated. /

Create dataset

requires authentication

Example request:
curl --request POST \
    "https://app.pollinatorhub.eu/api/v1/datasets" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"ISO 3166-1:2020\",
    \"description\": \"Enim aut perspiciatis minima enim vel.\",
    \"data_overview\": \"umrzparbpegdxn\",
    \"data_value\": \"dkknduhisnffylnaco\",
    \"data_description\": \"lskqzextfyokkzhlfmqjctxm\",
    \"data_application\": \"hjfutujrlvtlaoalmqs\",
    \"data_issues\": \"wodlvdcomybthoitba\",
    \"introduction\": \"qldvxqpelinrwfys\",
    \"acquisition\": \"gphjxrinfpkogbssjujzwrvm\",
    \"preparation\": \"cdpkednfmcf\",
    \"validation\": \"lppfhysfchwawezreeqtdk\",
    \"analysis\": \"eexnjbvevjlxgkqqhljzlnog\",
    \"licence\": \"cc-by\",
    \"entities\": [
        \"euph\"
    ],
    \"public\": true,
    \"published_at\": \"2023-07-04T11:24:58.000000Z\",
    \"contacts\": [
        {
            \"type\": \"url-vimeo\",
            \"value\": \"soktudwrbdvtoucjisstwpkjmxathtpenjvc\"
        }
    ]
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'ISO 3166-1:2020',
            'description' => 'Enim aut perspiciatis minima enim vel.',
            'data_overview' => 'umrzparbpegdxn',
            'data_value' => 'dkknduhisnffylnaco',
            'data_description' => 'lskqzextfyokkzhlfmqjctxm',
            'data_application' => 'hjfutujrlvtlaoalmqs',
            'data_issues' => 'wodlvdcomybthoitba',
            'introduction' => 'qldvxqpelinrwfys',
            'acquisition' => 'gphjxrinfpkogbssjujzwrvm',
            'preparation' => 'cdpkednfmcf',
            'validation' => 'lppfhysfchwawezreeqtdk',
            'analysis' => 'eexnjbvevjlxgkqqhljzlnog',
            'licence' => 'cc-by',
            'entities' => [
                'euph',
            ],
            'public' => true,
            'published_at' => '2023-07-04T11:24:58.000000Z',
            'contacts' => [
                [
                    'type' => 'url-vimeo',
                    'value' => 'soktudwrbdvtoucjisstwpkjmxathtpenjvc',
                ],
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/datasets"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "ISO 3166-1:2020",
    "description": "Enim aut perspiciatis minima enim vel.",
    "data_overview": "umrzparbpegdxn",
    "data_value": "dkknduhisnffylnaco",
    "data_description": "lskqzextfyokkzhlfmqjctxm",
    "data_application": "hjfutujrlvtlaoalmqs",
    "data_issues": "wodlvdcomybthoitba",
    "introduction": "qldvxqpelinrwfys",
    "acquisition": "gphjxrinfpkogbssjujzwrvm",
    "preparation": "cdpkednfmcf",
    "validation": "lppfhysfchwawezreeqtdk",
    "analysis": "eexnjbvevjlxgkqqhljzlnog",
    "licence": "cc-by",
    "entities": [
        "euph"
    ],
    "public": true,
    "published_at": "2023-07-04T11:24:58.000000Z",
    "contacts": [
        {
            "type": "url-vimeo",
            "value": "soktudwrbdvtoucjisstwpkjmxathtpenjvc"
        }
    ]
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/datasets'
payload = {
    "name": "ISO 3166-1:2020",
    "description": "Enim aut perspiciatis minima enim vel.",
    "data_overview": "umrzparbpegdxn",
    "data_value": "dkknduhisnffylnaco",
    "data_description": "lskqzextfyokkzhlfmqjctxm",
    "data_application": "hjfutujrlvtlaoalmqs",
    "data_issues": "wodlvdcomybthoitba",
    "introduction": "qldvxqpelinrwfys",
    "acquisition": "gphjxrinfpkogbssjujzwrvm",
    "preparation": "cdpkednfmcf",
    "validation": "lppfhysfchwawezreeqtdk",
    "analysis": "eexnjbvevjlxgkqqhljzlnog",
    "licence": "cc-by",
    "entities": [
        "euph"
    ],
    "public": true,
    "published_at": "2023-07-04T11:24:58.000000Z",
    "contacts": [
        {
            "type": "url-vimeo",
            "value": "soktudwrbdvtoucjisstwpkjmxathtpenjvc"
        }
    ]
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Request   

POST api/v1/datasets

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

name   string   

The name of the Dataset Part. Must not be greater than 100 characters. Must be at least 3 characters. Example: ISO 3166-1:2020

long_name   string  optional  

The long version of the name of the dataset. Must not be greater than 256 characters. Must be at least 5 characters.

description   string  optional  

Abstract about the dataset. Uses Markdown for styling. Must not be greater than 150000 characters. Example: Enim aut perspiciatis minima enim vel.

data_overview   string  optional  

Concise information (less than 200 words) about: e.g. provider of the data (who?); origin of the data and the subject area covered by the dataset (what?); geographical origin of the data (where?); time period covered by the dataset (when?). Uses Markdown for styling. Must not be greater than 150000 characters. Example: umrzparbpegdxn

data_value   string  optional  

Concise information (less than 200 words) about: e.g. reason for collecting the data; possible benefits resulting from the collection of the data (why?). Uses Markdown for styling. Must not be greater than 150000 characters. Example: dkknduhisnffylnaco

data_description   string  optional  

Concise description (less than 200 words) of the dataset metrics: e.g. number of files; categories of data; size of the datasets in bytes. Uses Markdown for styling. Must not be greater than 150000 characters. Example: lskqzextfyokkzhlfmqjctxm

data_application   string  optional  

A concise summary (less than 200 words) of possible applications for which the data could be used, scientific or technical questions or other issues that could be addressed (for what?). Uses Markdown for styling. Must not be greater than 150000 characters. Example: hjfutujrlvtlaoalmqs

data_issues   string  optional  

A list of unresolved issues and quality concerns. Uses Markdown for styling. Must not be greater than 150000 characters. Example: wodlvdcomybthoitba

introduction   string  optional  

A longer description about the dataset. Uses Markdown for styling. Must not be greater than 150000 characters. Example: qldvxqpelinrwfys

acquisition   string  optional  

Description of or a reference to material and methods used to acquire the data in the dataset and a detailed list of terms under which the data has been made available (licensing).Uses Markdown for styling. Must not be greater than 150000 characters. Example: gphjxrinfpkogbssjujzwrvm

preparation   string  optional  

Detailed description of material (product, model) and methods (provide references if possible) used to prepare the dataset. Uses Markdown for styling. Must not be greater than 150000 characters. Example: cdpkednfmcf

validation   string  optional  

Detailed description of material (product, model) and methods (provide references if possible) used to validate the dataset for the purpose of data quality assessment. Uses Markdown for styling. Must not be greater than 150000 characters. Example: lppfhysfchwawezreeqtdk

analysis   string  optional  

etailed description of material (product, model) and methods (provide references if possible) used to analyse the dataset for the purpose of data quality assessment. Uses Markdown for styling. Must not be greater than 150000 characters. Example: eexnjbvevjlxgkqqhljzlnog

licence   string  optional  

The UID of the licence of this entity. Example: cc-by

Must be one of:
  • cc-by-4-0
  • cc-by-nc-4-0
  • cc-by-nc-nd-4-0
  • cc-by-nc-sa-3.0-igo
  • cc-by-nc-sa-4-0
  • cc-by-nd-4-0
  • cc-by-sa-4-0
  • cc0-1-0
  • eurostat
  • statcube
  • table-specific-licence
entities   string[]   

The UID of of an related Entity. The uid of an existing record in the user_entities table.

contacts   object[]  optional  
type   string   

Example: url-vimeo

Must be one of:
  • address
  • email
  • phone
  • url
  • url-facebook
  • url-linkedin
  • url-orcid
  • url-research-gate
  • url-twitter
  • url-vimeo
  • url-youtube
value   string   

Must be at least 5 characters. Example: soktudwrbdvtoucjisstwpkjmxathtpenjvc

public   boolean   

Setting this Dataset Part public attribute to true will make accessible to the public while setting it to false will make it only be used for processing. Example: true

published_at   string  optional  

The date this Dataset Part can be published on the platform. A null value is allowed, having no or unknown publishing date. Must be a valid date. Example: 2023-07-04T11:24:58.000000Z

Show dataset

requires authentication

Display the specified Dataset based on provided unique identifier.

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/datasets/4" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets/4';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/datasets/4"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/datasets/4'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 56
access-control-allow-origin: *
 

{
    "data": {
        "id": 4,
        "uid": "PSTCD4.0.0",
        "name": "Postcode",
        "long_name": "Postcodes from various countries",
        "description": "The dataset contains postcodes from 97 countries for internal use on the EUPH.",
        "featured_image": null,
        "data_overview": null,
        "data_value": null,
        "data_description": null,
        "data_application": null,
        "data_issues": null,
        "introduction": null,
        "acquisition": null,
        "preparation": null,
        "validation": null,
        "analysis": null,
        "status": "publish",
        "public": false,
        "licence": {
            "uid": "cc-by-4-0",
            "name": "CC BY 4.0",
            "abbreviation": "CC BY 4.0",
            "description": "### You are free to:\n\n* Share — copy and redistribute the material in any medium or format for any purpose, even commercially.\n* Adapt — remix, transform, and build upon the material for any purpose, even commercially.\n* The licensor cannot revoke these freedoms as long as you follow the license terms.\n\n### Under the following terms:\n\n* Attribution - You must give appropriate credit , provide a link to the license, and indicate if changes were made . You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.\n* No additional restrictions - You may not apply legal terms or technological measures that legally restrict others from doing anything the license permits.\n\n### Notices:\n\nYou do not have to comply with the license for elements of the material in the public domain or where your use is permitted by an applicable exception or limitation.\n\nNo warranties are given. The license may not give you all of the permissions necessary for your intended use. For example, other rights such as publicity, privacy, or moral rights may limit how you use the material.\n",
            "url_summary": "https://creativecommons.org/licenses/by/4.0/",
            "url_legal": "https://creativecommons.org/licenses/by/4.0/legalcode",
            "image_url": "/storage/01HF961C5YQASH3TQ6MNYKN9WN.svg"
        },
        "contacts": [],
        "entities": [
            {
                "id": 3,
                "uid": "euph",
                "name": "EU Pollinator Hub",
                "type": "legal-entity",
                "abbreviation": "EUPH",
                "created_at": "2023-10-05T10:02:30.000000Z",
                "updated_at": "2024-06-04T12:59:02.000000Z"
            }
        ],
        "contributors": [],
        "parts": [
            {
                "id": 72,
                "uid": "PSTCD4.WRLDW72.0",
                "name": "Worldwide postcodes",
                "description": "The table contains postcodes from 97 countries.",
                "featured_image": null,
                "type": "file",
                "licence": "cc-by-4-0",
                "created_at": "2023-10-05T07:59:13.000000Z",
                "updated_at": "2024-01-25T09:26:57.000000Z"
            }
        ],
        "descriptors": [],
        "published_at": "2023-09-12T22:00:00.000000Z",
        "created_at": "2023-01-26T18:18:06.000000Z",
        "updated_at": "2024-01-26T19:17:49.000000Z"
    }
}
 

Request   

GET api/v1/datasets/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The unique identifier used to identify the Dataset within the platform. Example: 4

Response

Response Fields

data   object[]   

A list of metadata associated with the requested dataset.

id   integer   

Numeric identifier of the dataset.

uid   string   

The unique identifier used to identify the entity within the platform.

name   string   

The actual name of the dataset.

long_name   string   

The long version of the name of the dataset.

description   string   

Abstract about the dataset. Uses Markdown for styling.

featured_image   string|null   

URL to uploaded image representing this dataset.

data_overview   string   

Concise information (less than 200 words) about: e.g. provider of the data (who?); origin of the data and the subject area covered by the dataset (what?); geographical origin of the data (where?); time period covered by the dataset (when?). Uses Markdown for styling.

data_value   string   

Concise information (less than 200 words) about: e.g. reason for collecting the data; possible benefits resulting from the collection of the data (why?). Uses Markdown for styling.

data_description   string   

Concise description (less than 200 words) of the dataset metrics: e.g. number of files; categories of data; size of the datasets in bytes. Uses Markdown for styling.

data_application   string   

A concise summary (less than 200 words) of possible applications for which the data could be used, scientific or technical questions or other issues that could be addressed (for what?). Uses Markdown for styling.

data_issues   string   

A list of unresolved issues and quality concerns. Uses Markdown for styling.

introduction   string   

A longer description about the dataset. Uses Markdown for styling.

acquisition   string   

Description of or a reference to material and methods used to acquire the data in the dataset and a detailed list of terms under which the data has been made available (licensing).Uses Markdown for styling.

preparation   string   

Detailed description of material (product, model) and methods (provide references if possible) used to prepare the dataset. Uses Markdown for styling.

validation   string   

Detailed description of material (product, model) and methods (provide references if possible) used to validate the dataset for the purpose of data quality assessment. Uses Markdown for styling.

analysis   string   

Detailed description of material (product, model) and methods (provide references if possible) used to analyse the dataset for the purpose of data quality assessment. Uses Markdown for styling.

status   string   

The status of the dataset. The list of available status are the following: draft, pending, reject, reviewing, pending-peer-rev, peer-reviewing, publish, publish-with-pw, trash, hidden

public   boolean   

Value of 1 means that the data of this dataset are publicly accessible.

licence      

array|null The licence information of this entity.

name   string   

The name of the licence.

abbreviation   string   

The short name of the licence.

description   string   

The description of the licence.

uid   string   

The unique identifier of the licence.

url_summary   string|null   

Url to external description of this licence.

url_legal   string|null   

Url to external legal definition of this licence.

image_url   string|null   

Url to licence image representation.

contact   object[]   

A list of contact points for the entity.

type   string   

The type of the contact.

value   string   

The actual value of the contact, for

entities   string[]   

Array containing the uid of the entities of this dataset.

*   string   

The Uid of the entity.

contributors   string[]   

Array containing the uid of the contributors of this dataset.

*   string   

The Uid of the contributor.

parts   string[]   

An array containing all related dataset tables. Field is hidden for non-public datasets.

*   object   
uid   string   

The unique identifier used to identify the table within the platform.

name   string   

Name of the table.

description   string   

Description of the table. Uses Markdown for styling.

structure   string   

An unordered list of potential links between columns of the same file, of different files of the same dataset or of different files of different datasets as follows: Column [dataset].[file].[column] links on [dataset].[file].[column]. Uses Markdown for styling.

preparation   string   

It contains an unordered list of all changes made in the preparatory file described in the parent section according to Directory-006 (Dataset preparation). Uses Markdown for styling.

changes   string   

It contains an unordered list of all changes made in the data after integration of the file described in the parent section into the EUPH according to Directory-006 (Dataset preparation). Uses Markdown for styling.

unresolved   string   

It contains an unordered list of all unresolved issues in the file of the parent section requiring intervention by the data provider according to Directory-007 (Data profiling). Uses Markdown for styling.

created_at   string   

The date and time the table was created.

updated_at   string   

The date and time the table was last updated.

id   integer   

Numeric identifier of the table.

descriptors   string[]   

An array of all descriptors, used to integrate this dataset. Field is hidden for non-public datasets.

*   object   
uid   string   

The unique identifier used to identify the descriptor within the platform.

namespace   string|null   

The namespace this descriptor belongs to.

name   string   

Name of the descriptor.

description   string|null   

A short, concise description of the descriptor. If a class is assigned to descriptor, this field contains the accepted definition of the related class. Uses Markdown for styling.

notes   string|null   

Any additional notes attached to the descriptor. Uses Markdown for styling.

examples   string|null   

A list of examples, how the data may appear. Uses Markdown for styling.

class   string|null   

An optional class, related to this descriptor.

unit   string|null   

The unit data is saved in. May not be set.

deprecated   boolean   

Whether this descriptor is deprecated or not. Deprecated descriptors can not be used to import new data.

created_at   string   

The date and time the table was created.

updated_at   string   

The date and time the table was last updated.

published_at   string|null   

The date and time the dataset was published.

created_at   string   

The date and time the dataset was created.

updated_at   string   

The date and time the dataset was last updated.

Update dataset

requires authentication

Example request:
curl --request PUT \
    "https://app.pollinatorhub.eu/api/v1/datasets/1" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"entities\": [
        \"euph\"
    ],
    \"name\": \"ISO 3166-1:2020\",
    \"long_name\": \"No-example\",
    \"description\": \"Ea maxime eligendi rerum laborum eos.\",
    \"data_overview\": \"joeeyfwiqo\",
    \"data_value\": \"azvzqipwarjsecae\",
    \"data_description\": \"bpuermdwpiqveblwnz\",
    \"data_application\": \"xmgafqvbnuibamtyvalhzj\",
    \"data_issues\": \"qhzjgscbvhnwkczswgxnibnl\",
    \"introduction\": \"vgzvkmnxxoihsk\",
    \"acquisition\": \"tmlbqlofmgr\",
    \"preparation\": \"wbi\",
    \"validation\": \"ngjbmekkznhdwgvngwezo\",
    \"analysis\": \"lwknuhcdotq\",
    \"licence\": \"cc-by\",
    \"public\": true,
    \"published_at\": \"2023-07-04T11:24:58.000000Z\"
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets/1';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'entities' => [
                'euph',
            ],
            'name' => 'ISO 3166-1:2020',
            'long_name' => 'No-example',
            'description' => 'Ea maxime eligendi rerum laborum eos.',
            'data_overview' => 'joeeyfwiqo',
            'data_value' => 'azvzqipwarjsecae',
            'data_description' => 'bpuermdwpiqveblwnz',
            'data_application' => 'xmgafqvbnuibamtyvalhzj',
            'data_issues' => 'qhzjgscbvhnwkczswgxnibnl',
            'introduction' => 'vgzvkmnxxoihsk',
            'acquisition' => 'tmlbqlofmgr',
            'preparation' => 'wbi',
            'validation' => 'ngjbmekkznhdwgvngwezo',
            'analysis' => 'lwknuhcdotq',
            'licence' => 'cc-by',
            'public' => true,
            'published_at' => '2023-07-04T11:24:58.000000Z',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/datasets/1"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "entities": [
        "euph"
    ],
    "name": "ISO 3166-1:2020",
    "long_name": "No-example",
    "description": "Ea maxime eligendi rerum laborum eos.",
    "data_overview": "joeeyfwiqo",
    "data_value": "azvzqipwarjsecae",
    "data_description": "bpuermdwpiqveblwnz",
    "data_application": "xmgafqvbnuibamtyvalhzj",
    "data_issues": "qhzjgscbvhnwkczswgxnibnl",
    "introduction": "vgzvkmnxxoihsk",
    "acquisition": "tmlbqlofmgr",
    "preparation": "wbi",
    "validation": "ngjbmekkznhdwgvngwezo",
    "analysis": "lwknuhcdotq",
    "licence": "cc-by",
    "public": true,
    "published_at": "2023-07-04T11:24:58.000000Z"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/datasets/1'
payload = {
    "entities": [
        "euph"
    ],
    "name": "ISO 3166-1:2020",
    "long_name": "No-example",
    "description": "Ea maxime eligendi rerum laborum eos.",
    "data_overview": "joeeyfwiqo",
    "data_value": "azvzqipwarjsecae",
    "data_description": "bpuermdwpiqveblwnz",
    "data_application": "xmgafqvbnuibamtyvalhzj",
    "data_issues": "qhzjgscbvhnwkczswgxnibnl",
    "introduction": "vgzvkmnxxoihsk",
    "acquisition": "tmlbqlofmgr",
    "preparation": "wbi",
    "validation": "ngjbmekkznhdwgvngwezo",
    "analysis": "lwknuhcdotq",
    "licence": "cc-by",
    "public": true,
    "published_at": "2023-07-04T11:24:58.000000Z"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('PUT', url, headers=headers, json=payload)
response.json()

Request   

PUT api/v1/datasets/{id}

PATCH api/v1/datasets/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The ID of the dataset. Example: 1

Body Parameters

entities   string[]   

The UID of of an related Entity. The uid of an existing record in the user_entities table.

name   string   

The name of the Dataset Part. Must not be greater than 100 characters. Must be at least 3 characters. Example: ISO 3166-1:2020

long_name   string   

The long version of the name of the dataset. Must not be greater than 256 characters. Must be at least 8 characters. Example: No-example

description   string   

Abstract about the dataset. Uses Markdown for styling. Must not be greater than 150000 characters. Example: Ea maxime eligendi rerum laborum eos.

data_overview   string   

Concise information (less than 200 words) about: e.g. provider of the data (who?); origin of the data and the subject area covered by the dataset (what?); geographical origin of the data (where?); time period covered by the dataset (when?). Uses Markdown for styling. Must not be greater than 150000 characters. Example: joeeyfwiqo

data_value   string   

Concise information (less than 200 words) about: e.g. reason for collecting the data; possible benefits resulting from the collection of the data (why?). Uses Markdown for styling. Must not be greater than 150000 characters. Example: azvzqipwarjsecae

data_description   string   

Concise description (less than 200 words) of the dataset metrics: e.g. number of files; categories of data; size of the datasets in bytes. Uses Markdown for styling. Must not be greater than 150000 characters. Example: bpuermdwpiqveblwnz

data_application   string   

A concise summary (less than 200 words) of possible applications for which the data could be used, scientific or technical questions or other issues that could be addressed (for what?). Uses Markdown for styling. Must not be greater than 150000 characters. Example: xmgafqvbnuibamtyvalhzj

data_issues   string   

A list of unresolved issues and quality concerns. Uses Markdown for styling. Must not be greater than 150000 characters. Example: qhzjgscbvhnwkczswgxnibnl

introduction   string   

A longer description about the dataset. Uses Markdown for styling. Must not be greater than 150000 characters. Example: vgzvkmnxxoihsk

acquisition   string   

Description of or a reference to material and methods used to acquire the data in the dataset and a detailed list of terms under which the data has been made available (licensing).Uses Markdown for styling. Must not be greater than 150000 characters. Example: tmlbqlofmgr

preparation   string   

Detailed description of material (product, model) and methods (provide references if possible) used to prepare the dataset. Uses Markdown for styling. Must not be greater than 150000 characters. Example: wbi

validation   string   

Detailed description of material (product, model) and methods (provide references if possible) used to validate the dataset for the purpose of data quality assessment. Uses Markdown for styling. Must not be greater than 150000 characters. Example: ngjbmekkznhdwgvngwezo

analysis   string   

etailed description of material (product, model) and methods (provide references if possible) used to analyse the dataset for the purpose of data quality assessment. Uses Markdown for styling. Must not be greater than 150000 characters. Example: lwknuhcdotq

licence   string   

The UID of the licence of this entity. Example: cc-by

Must be one of:
  • cc-by-4-0
  • cc-by-nc-4-0
  • cc-by-nc-nd-4-0
  • cc-by-nc-sa-3.0-igo
  • cc-by-nc-sa-4-0
  • cc-by-nd-4-0
  • cc-by-sa-4-0
  • cc0-1-0
  • eurostat
  • statcube
  • table-specific-licence
public   boolean   

Setting this Dataset Part public attribute to true will make accessible to the public while setting it to false will make it only be used for processing. Example: true

published_at   string  optional  

The date this Dataset Part can be published on the platform. A null value is allowed, having no or unknown publishing date. Must be a valid date. Example: 2023-07-04T11:24:58.000000Z

Delete dataset

requires authentication

<aside class"warning">Only dataset without any tables can be deleted.

Example request:
curl --request DELETE \
    "https://app.pollinatorhub.eu/api/v1/datasets/1" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets/1';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/datasets/1"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/datasets/1'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('DELETE', url, headers=headers)
response.json()

Request   

DELETE api/v1/datasets/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The ID of the dataset. Example: 1

Tables

Routes used to manage Dataset Tables.

List tables

requires authentication

Display a list of all tables of the supplied dataset.

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/datasets/2/parts" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets/2/parts';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/datasets/2/parts"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/datasets/2/parts'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):


{
    "data": [
        {
            "name": "ISO 3166-1:2020",
            "description": "File iso3166_1_2020.csv contains 291 records of countries included in the ISO standard 3166-1:2020...",
            "uid": "DTST1.PRTA1.0",
            "type": "file",
            "licence_id": "unlicenced",
            "created_at": "2023-07-04T11:24:58.000000Z",
            "updated_at": "2023-07-04T11:24:58.000000Z"
        }
    ]
}
 

Request   

GET api/v1/datasets/{dataset_id}/parts

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

dataset_id   integer   

numeric identifier used to identify the dataset to display related parts of. Example: 2

Response

Response Fields

data   object[]   

A list of dataset tables available to the User.

*   object   
id   integer   

Numeric identifier of the table.

uid   string   

The unique identifier used to identify the table within the platform.

name   string   

The title of the table.

description   string|null   

Detailed description of the table.

featured_image   string|null   

URL to uploaded image representing this table.

type   string   

The type of this table.

licence   string|null   

The licence defined specifically for this table.

created_at   string   

The date and time it was created.

updated_at   string   

The date and time it was last updated.

Create table

requires authentication

Create and attach a new table to the supplied dataset.

Example request:
curl --request POST \
    "https://app.pollinatorhub.eu/api/v1/datasets/2/parts" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"ISO 3166-1:2020\",
    \"type\": \"api\"
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/datasets/2/parts';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'ISO 3166-1:2020',
            'type' => 'api',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/datasets/2/parts"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "ISO 3166-1:2020",
    "type": "api"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/datasets/2/parts'
payload = {
    "name": "ISO 3166-1:2020",
    "type": "api"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Request   

POST api/v1/datasets/{dataset_id}/parts

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

dataset_id   integer   

numeric identifier used to identify the dataset to display related parts of. Example: 2

Body Parameters

name   string   

The title of the table. Must not be greater than 30 characters. Example: ISO 3166-1:2020

type   string   

The type this Dataset Part represents. Use 'api' when uploading data via the API. Example: api

Must be one of:
  • api
  • file
  • files
  • spreadsheet
description   string  optional  

Detailed description of the table. Accepts Markdown for styling. Must not be greater than 10000 characters.

structure   string  optional  

An unordered list of potential links between columns of the same file, of different files of the same dataset or of different files of different datasets as follows: Column [dataset].[file].[column] links on [dataset].[file].[column]. Must not be greater than 50000 characters.

preparation   string  optional  

It contains an unordered list of all changes made in the preparatory file described in the parent section according to Directory-006 (Dataset preparation). Must not be greater than 50000 characters.

changes   string  optional  

It contains an unordered list of all changes made in the data after integration of the file described in the parent section into the EUPH according to Directory-006 (Dataset preparation). Must not be greater than 50000 characters.

unresolved   string  optional  

It contains an unordered list of all unresolved issues in the file of the parent section requiring intervention by the data provider according to Directory-007 (Data profiling). Must not be greater than 50000 characters.

additional_information   string  optional  

Any additional information required to acquire this table data. Must not be greater than 50000 characters.

Show table

requires authentication

Retrieve metadata for a single table within a dataset.

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/parts/5" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/5';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/parts/5"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/parts/5'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 55
access-control-allow-origin: *
 

{
    "data": {
        "id": 5,
        "uid": "UNSDA25.NCMTR5.0",
        "name": "Un Comtrade Units",
        "description": "This table contains quantity units used in detailed UN Comtrade data, based on the standards of quantity recommended by the World Customs Organization (WCO).",
        "featured_image": null,
        "structure": null,
        "preparation": "None",
        "changes": "None",
        "unresolved": "None",
        "additional_information": null,
        "type": "file",
        "licence": "euph",
        "columns": [
            {
                "id": 1882,
                "name": "UnsdId",
                "description": null,
                "descriptor": {
                    "id": 849,
                    "uid": "0.0.NSDNT849",
                    "namespace": "unsd",
                    "name": "unsdUnitID",
                    "description": "Special units maintained by the [United Nations Statistics Division (UNSD)](https://app.pollinatorhub.eu/vocabulary/classes/7822)).",
                    "class": "[EUPH-code: 8037]",
                    "unit": null,
                    "created_at": "2025-02-12T17:44:44.000000Z",
                    "updated_at": "2025-02-14T11:53:11.000000Z"
                },
                "unit": null,
                "datatype": {
                    "label": "Integer",
                    "priority": 10
                },
                "order": 0,
                "created_at": "2024-01-26T18:44:26.000000Z",
                "updated_at": "2025-02-14T11:53:52.000000Z"
            },
            {
                "id": 1883,
                "name": "WCOAbbreviation",
                "description": null,
                "descriptor": {
                    "id": 315,
                    "uid": "0.0.TEXTA315",
                    "namespace": null,
                    "name": "Text",
                    "description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
                    "class": "[EUPH-code: 7322]",
                    "unit": null,
                    "created_at": null,
                    "updated_at": "2024-09-14T11:17:02.000000Z"
                },
                "unit": null,
                "datatype": {
                    "label": "String",
                    "priority": 100
                },
                "order": 0,
                "created_at": "2024-01-26T18:44:26.000000Z",
                "updated_at": "2025-02-14T11:53:52.000000Z"
            },
            {
                "id": 1884,
                "name": "Description",
                "description": null,
                "descriptor": {
                    "id": 315,
                    "uid": "0.0.TEXTA315",
                    "namespace": null,
                    "name": "Text",
                    "description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
                    "class": "[EUPH-code: 7322]",
                    "unit": null,
                    "created_at": null,
                    "updated_at": "2024-09-14T11:17:02.000000Z"
                },
                "unit": null,
                "datatype": {
                    "label": "String",
                    "priority": 100
                },
                "order": 0,
                "created_at": "2024-01-26T18:44:26.000000Z",
                "updated_at": "2025-02-14T11:53:52.000000Z"
            }
        ],
        "data_files": [
            {
                "id": 886,
                "name": "euph_000025_unsd_table_uncomtradeunits.csv",
                "description": null,
                "status": "analyzed",
                "type": "csv",
                "mimetype": "text/csv",
                "file_size": 483,
                "download_count": 0,
                "created_at": "2025-02-14T11:32:07.000000Z",
                "updated_at": "2025-02-14T11:35:06.000000Z"
            }
        ],
        "supplemental_files": [],
        "created_at": "2023-02-04T14:56:12.000000Z",
        "updated_at": "2025-04-18T09:26:56.000000Z"
    }
}
 

Request   

GET api/v1/parts/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The numeric identifier used to identify the table within the platform. Example: 5

Response

Response Fields

data   object[]   

A list of metadata associated with the requested dataset table.

id   integer   

Numeric identifier of the table.

uid   string   

The unique identifier used to identify the table within the platform.

name   string   

The title of the table.

description   string|null   

Detailed description of the table.

featured_image   string|null   

URL to uploaded image representing this table.

structure   string|null   

An unordered list of potential links between columns of the same file, of different files of the same dataset or of different files of different datasets as follows: Column [dataset].[file].[column] links on [dataset].[file].[column].

preparation   string|null   

It contains an unordered list of all changes made in the preparatory file described in the parent section according to Directory-006 (Dataset preparation).

changes   string|null   

It contains an unordered list of all changes made in the data after integration of the file described in the parent section into the EUPH according to Directory-006 (Dataset preparation).

unresolved   string|null   

It contains an unordered list of all unresolved issues in the file of the parent section requiring intervention by the data provider according to Directory-007 (Data profiling).

type   string   

The type of this table.

additional_information   string|null   

Any additional information required to acquire this table data.

licence   string|null   

The licence defined specifically for this table.

columns   string[]   

A list of associated columns with this table.

*   object   
id   integer   

Numeric identifier of the column.

name   string   

The title of the column.

description   string|null   

Detailed description of the column.

descriptor   string[]   

The descriptor used to internally represent the data.

id   integer   

Numeric identifier of the descriptor.

uid   string   

The unique identifier used to identify the descriptor within the platform.

namespace   string|null   

The namespace this descriptor conforms to.

name   string   

The title of the descriptor.

description   string|null   

Detailed description of the descriptor.

class   string|null   

The class this descriptor is described by.

unit      

array|null The unit the data of this descriptor is saved in.

datatype   string[]   

The datatype this column saves data in.

label   string   

The label of the datatype.

priority   integer   

The priority ranking of this datatype.

order   integer   

The order of this column, that it appears in the table.

created_at   string   

The date and time it was created.

updated_at   string   

The date and time it was last updated.

data_files   string[]   

A list of uploaded data files.

*   object   
id   integer   

Numeric identifier of the uploaded file.

name   string   

The original filename.

description   string|null   
status   string   

The internal status of this file.

type   string   

Identified type of this file.

mimetype   string   

Identified mimetype of this file.

file_size   integer   

The filesize in bytes.

download_count      

intNumber of times this file was downloaded.

created_at   string   

The date and time it was created.

updated_at   string   

The date and time it was last updated.

supplemental_files   string[]   

A list of uploaded data files.

*   object   
id   integer   

Numeric identifier of the uploaded file.

name   string   

The original filename.

description   string|null   
status   string   

The internal status of this file.

type   string   

Identified type of this file.

mimetype      

stringIdentified mimetype of this file.

file_size      

intThe filesize in bytes.

download_count   integer   

Number of times this file was downloaded.

created_at   string   

The date and time it was created.

updated_at   string   

The date and time it was last updated.

created_at   string   

The date and time it was created.

updated_at   string   

The date and time it was last updated.

Update table

requires authentication

Update table metadata with new values.

Example request:
curl --request PUT \
    "https://app.pollinatorhub.eu/api/v1/parts/1" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"ISO 3166-1:2020\",
    \"description\": \"No-example\",
    \"type\": \"api\"
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'ISO 3166-1:2020',
            'description' => 'No-example',
            'type' => 'api',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/parts/1"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "ISO 3166-1:2020",
    "description": "No-example",
    "type": "api"
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/parts/1'
payload = {
    "name": "ISO 3166-1:2020",
    "description": "No-example",
    "type": "api"
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('PUT', url, headers=headers, json=payload)
response.json()

Request   

PUT api/v1/parts/{id}

PATCH api/v1/parts/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The numeric identifier used to identify the table within the platform. Example: 1

Body Parameters

name   string   

The name of the Dataset Part. Must not be greater than 150 characters. Must be at least 3 characters. Example: ISO 3166-1:2020

description   string   

A longer description about the Dataset Part. Accepts Markdown for styling. Must not be greater than 15000000 characters. Must be at least 10 characters. Example: No-example

type   string   

The type this Dataset Part represents. Use 'api' when uploading data via the API. The list of available types are: api ,file ,files ,remote ,spreadsheet ,survey. Example: api

Must be one of:
  • api
  • file
  • files
  • spreadsheet

Delete table.

requires authentication

Delete a single table. <aside class"warning">Only table with no uploaded data can be deleted.

Example request:
curl --request DELETE \
    "https://app.pollinatorhub.eu/api/v1/parts/1" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/parts/1"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/parts/1'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('DELETE', url, headers=headers)
response.json()

Example response (202):


{}
 

Request   

DELETE api/v1/parts/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The numeric identifier used to identify the Dataset Part within the platform. Example: 1

Columns

This route will allow modifications to the meta-data for individual columns of a dataset. It includes basic information like name, description and descriptor information. It is owned by one or more entities. It is identified by numeric ID which is created during creation procedure.

List columns

requires authentication

Display a listing of the Datasets, the User has access to.

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/parts/1/columns?entity=euph&page=1&limit=3" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1/columns';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'entity' => 'euph',
            'page' => '1',
            'limit' => '3',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/parts/1/columns"
);

const params = {
    "entity": "euph",
    "page": "1",
    "limit": "3",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/parts/1/columns'
params = {
  'entity': 'euph',
  'page': '1',
  'limit': '3',
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 54
access-control-allow-origin: *
 

{
    "current_page": 1,
    "data": [
        {
            "id": 1,
            "name": "CountryId",
            "description": null,
            "descriptor": {
                "id": 344,
                "uid": "0.0.RCRDD344",
                "namespace": "pms",
                "name": "recordID",
                "description": "Unique sequence of integers associated with a record within a certain table.",
                "class": "[EUPH-code: 3331]",
                "unit": null,
                "created_at": "2023-11-26T12:08:55.000000Z",
                "updated_at": "2025-02-06T15:51:38.000000Z"
            },
            "unit": null,
            "datatype": null,
            "order": 0,
            "created_at": "2023-09-01T08:53:37.000000Z",
            "updated_at": "2025-02-12T13:19:21.000000Z"
        },
        {
            "id": 2,
            "name": "NumericCode",
            "description": null,
            "descriptor": {
                "id": 519,
                "uid": "0.0.MAREA519",
                "namespace": "unsd",
                "name": "m49Area",
                "description": "Name of the countries or areas or geographic regions in the [M49 standard](https://app.pollinatorhub.eu/vocabulary/classes/7292) used for statistical processing purposes by the [Statistics Division of the United Nations Secretariat](https://unstats.un.org).",
                "class": "[EUPH-code: 7441]",
                "unit": null,
                "created_at": "2024-11-22T15:54:40.000000Z",
                "updated_at": "2025-02-06T12:33:33.000000Z"
            },
            "unit": null,
            "datatype": null,
            "order": 0,
            "created_at": "2023-09-01T08:53:37.000000Z",
            "updated_at": "2025-02-12T13:12:03.000000Z"
        },
        {
            "id": 3,
            "name": "FullName",
            "description": "Full name of the country, as recorded in [UNTERM](https://unterm.un.org).",
            "descriptor": {
                "id": 315,
                "uid": "0.0.TEXTA315",
                "namespace": null,
                "name": "Text",
                "description": "> In computer programming, a string is traditionally a sequence of characters, either as a literal constant or as some kind of variable. The latter may allow its elements to be mutated and the length changed, or it may be fixed (after creation). A string is generally considered as a data type and is often implemented as an array data structure of bytes (or words) that stores a sequence of elements, typically characters, using some character encoding. String may also denote more general arrays or other sequence (or list) data types and structures.",
                "class": "[EUPH-code: 7322]",
                "unit": null,
                "created_at": null,
                "updated_at": "2024-09-14T11:17:02.000000Z"
            },
            "unit": null,
            "datatype": null,
            "order": 0,
            "created_at": "2023-09-01T08:53:37.000000Z",
            "updated_at": "2025-02-12T13:12:03.000000Z"
        }
    ],
    "first_page_url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=1",
    "from": 1,
    "last_page": 5,
    "last_page_url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=5",
    "links": [
        {
            "url": null,
            "label": "&laquo; Previous",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=1",
            "label": "1",
            "active": true
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=2",
            "label": "2",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=3",
            "label": "3",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=4",
            "label": "4",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=5",
            "label": "5",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=2",
            "label": "Next &raquo;",
            "active": false
        }
    ],
    "next_page_url": "https://app.pollinatorhub.eu/api/v1/parts/1/columns?page=2",
    "path": "https://app.pollinatorhub.eu/api/v1/parts/1/columns",
    "per_page": 3,
    "prev_page_url": null,
    "to": 3,
    "total": 15
}
 

Request   

GET api/v1/parts/{part_id}/columns

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

part_id   integer   

The ID of the part. Example: 1

Query Parameters

entity   string  optional  

Filter datasets by Entity uid. Example: euph

page   integer  optional  

Load specified page to view the results. Default: 1 Example: 1

limit   integer  optional  

Set the amount of results the API returns. Up to 1000. Default: 100 Example: 3

Response

Response Fields

data   object[]   

A list of Datasets available to the User.

*   object   
id   integer   

Numeric identifier of the dataset.

name   string   

The actual name of the dataset.

long_name   string   

The long version of the name of the dataset.

uid   string   

The unique identifier used to identify the entity within the platform.

description   string   

Dataset abstract. Uses Markdown for styling.

featured_image   string|null   

URL to uploaded image representing this dataset.

status   string   

The status of the dataset. The list of available status are the following: draft, pending, reject, reviewing, pending-peer-rev, peer-reviewing, publish, publish-with-pw, trash, hidden

public   boolean   

1 means that the data of this dataset are public.

licence   string|null   

The uid of the licence of this entity.

published_at   string|null   

The date and time the dataset was published.

created_at   string   

The date and time the dataset was created.

updated_at   string   

The date and time the dataset was last updated.

Create column

requires authentication

Example request:
curl --request POST \
    "https://app.pollinatorhub.eu/api/v1/parts/1/columns" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"Hive scale weight\",
    \"descriptor\": \"0.0.LPHCN4\",
    \"datatype\": \"String, Integer, Decimal, Date, Time, DateTime, Boolean\",
    \"order\": 1
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1/columns';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'Hive scale weight',
            'descriptor' => '0.0.LPHCN4',
            'datatype' => 'String, Integer, Decimal, Date, Time, DateTime, Boolean',
            'order' => 1,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/parts/1/columns"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "Hive scale weight",
    "descriptor": "0.0.LPHCN4",
    "datatype": "String, Integer, Decimal, Date, Time, DateTime, Boolean",
    "order": 1
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/parts/1/columns'
payload = {
    "name": "Hive scale weight",
    "descriptor": "0.0.LPHCN4",
    "datatype": "String, Integer, Decimal, Date, Time, DateTime, Boolean",
    "order": 1
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Request   

POST api/v1/parts/{part_id}/columns

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

part_id   integer   

The ID of the part. Example: 1

Body Parameters

name   string   

The title of the column. Must not be greater than 30 characters. Example: Hive scale weight

description   string  optional  

Detailed description of the column. Accepts Markdown for styling. Must not be greater than 10000 characters.

descriptor   string   

The descriptor UID, used to represent the type of data within the column. Consult the documentation and vocabulary for a list of descriptors, available within the platform. The uid of an existing record in the descriptors table. Example: 0.0.LPHCN4

datatype   string  optional  

The datatype of the data within the column (case sensitive). Can be left blank to use the default Descriptor datatype. Consult the documentation and vocabulary for a list of available datatypes for each individual Descriptor. Example: String, Integer, Decimal, Date, Time, DateTime, Boolean

Must be one of:
  • Boolean
  • Coordinates
  • Date
  • DateTime
  • Decimal
  • Integer
  • String
  • Time
order   integer  optional  

Integer representing the column order number within the dataset. Used to organize tables when visualizing or exporting data. Example: 1

Show column

requires authentication

Display the specified dataset table column based on provided numeric identifier.

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/columns/4" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/columns/4';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/columns/4"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/columns/4'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers)
response.json()

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 53
access-control-allow-origin: *
 

{
    "data": {
        "id": 4,
        "name": "ShortName",
        "description": null,
        "descriptor": {
            "id": 3,
            "uid": "0.0.SHRTC3",
            "namespace": "iso-3166",
            "name": "shortUppercaseNameOfCountry",
            "description": "> [...] Short form of the country name [in capital letters], distinctive word first. [...] In [language of the ISO 3166 standard](https://app.pollinatorhub.eu/vocabulary/classes/7930). [...] This item might be inverted, allowing the distinctive word to appear first, so that items can be easily found in an alphabetical list. See [Annex F]https://www.iso.org/obp/ui/en/#iso:std:iso:3166:-1:ed-4:v1:en:sec:F), principles [F.2](https://www.iso.org/obp/ui/en/#iso:std:iso:3166:-1:ed-4:v1:en:sec:F.2).",
            "class": "[EUPH-code: 7929]",
            "unit": null,
            "created_at": "2022-11-19T09:03:29.000000Z",
            "updated_at": "2025-02-12T11:56:33.000000Z"
        },
        "unit": null,
        "datatype": null,
        "order": 0,
        "created_at": "2023-09-01T08:53:37.000000Z",
        "updated_at": "2025-02-12T13:12:03.000000Z"
    }
}
 

Request   

GET api/v1/columns/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The unique identifier used to identify the Dataset within the platform. Example: 4

Response

Response Fields

data   object[]   

A list of metadata associated with the requested dataset.

id   integer   

Numeric identifier of the dataset.

uid   string   

The unique identifier used to identify the entity within the platform.

name   string   

The actual name of the dataset.

created_at   string   

The date and time the dataset was created.

updated_at   string   

The date and time the dataset was last updated.

Update column

requires authentication

Example request:
curl --request PUT \
    "https://app.pollinatorhub.eu/api/v1/columns/1" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"Hive scale weight\",
    \"descriptor\": \"0.0.LPHCN4\",
    \"datatype\": \"String, Integer, Decimal, Date, Time, DateTime, Boolean\",
    \"order\": 1
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/columns/1';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'name' => 'Hive scale weight',
            'descriptor' => '0.0.LPHCN4',
            'datatype' => 'String, Integer, Decimal, Date, Time, DateTime, Boolean',
            'order' => 1,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/columns/1"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "name": "Hive scale weight",
    "descriptor": "0.0.LPHCN4",
    "datatype": "String, Integer, Decimal, Date, Time, DateTime, Boolean",
    "order": 1
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/columns/1'
payload = {
    "name": "Hive scale weight",
    "descriptor": "0.0.LPHCN4",
    "datatype": "String, Integer, Decimal, Date, Time, DateTime, Boolean",
    "order": 1
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('PUT', url, headers=headers, json=payload)
response.json()

Request   

PUT api/v1/columns/{id}

PATCH api/v1/columns/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The ID of the column. Example: 1

Body Parameters

name   string   

The title of the column. Must not be greater than 30 characters. Example: Hive scale weight

description   string  optional  

Detailed description of the column. Accepts Markdown for styling. Must not be greater than 10000 characters.

descriptor   string   

The descriptor UID, used to represent the type of data within the column. Consult the documentation and vocabulary for a list of descriptors, available within the platform. The uid of an existing record in the descriptors table. Example: 0.0.LPHCN4

datatype   string  optional  

The datatype of the data within the column (case sensitive). Can be left blank to use the default Descriptor datatype. Consult the documentation and vocabulary for a list of available datatypes for each individual Descriptor. Example: String, Integer, Decimal, Date, Time, DateTime, Boolean

Must be one of:
  • Boolean
  • Coordinates
  • Date
  • DateTime
  • Decimal
  • Integer
  • String
  • Time
order   integer  optional  

Integer representing the column order number within the dataset. Used to organize tables when visualizing or exporting data. Example: 1

Delete column

requires authentication

Example request:
curl --request DELETE \
    "https://app.pollinatorhub.eu/api/v1/columns/1" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/columns/1';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/columns/1"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/columns/1'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('DELETE', url, headers=headers)
response.json()

Request   

DELETE api/v1/columns/{id}

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

id   integer   

The ID of the column. Example: 1

Data

APIs for managing data records and values.

List Data

requires authentication

Display a listing of all data related to this Dataset Part. Is paginated..

Example request:
curl --request GET \
    --get "https://app.pollinatorhub.eu/api/v1/parts/1/data?limit=3" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1/data';
$response = $client->get(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'query' => [
            'limit' => '3',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/parts/1/data"
);

const params = {
    "limit": "3",
};
Object.keys(params)
    .forEach(key => url.searchParams.append(key, params[key]));

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/parts/1/data'
params = {
  'limit': '3',
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('GET', url, headers=headers, params=params)
response.json()

Example response (200):

Show headers
cache-control: no-cache, private
content-type: application/json
resource-api-success:
x-ratelimit-limit: 60
x-ratelimit-remaining: 52
access-control-allow-origin: *
 

{
    "current_page": 1,
    "data": [
        {
            "id": 1,
            "timestamp": "2020",
            "data": [
                {
                    "descriptor": "0.0.SHRTC3",
                    "column": "ShortName",
                    "column_id": 4,
                    "value": "ANTARCTICA",
                    "unit": null
                },
                {
                    "descriptor": "0.0.LPHCN4",
                    "column": "Alpha2Code",
                    "column_id": 6,
                    "value": "AQ",
                    "unit": null
                },
                {
                    "descriptor": "0.0.LPHCN5",
                    "column": "Alpha3Code",
                    "column_id": 7,
                    "value": "ATA",
                    "unit": null
                },
                {
                    "descriptor": "0.0.SHRTC10",
                    "column": "ShortNameLcEn",
                    "column_id": 5,
                    "value": "Antarctica",
                    "unit": null
                },
                {
                    "descriptor": "0.0.TEXTA315",
                    "column": "Status",
                    "column_id": 11,
                    "value": "Officially assigned",
                    "unit": null
                },
                {
                    "descriptor": "0.0.TEXTA315",
                    "column": "AnnotationP1En",
                    "column_id": 13,
                    "value": "Territories south of 60° south latitude.",
                    "unit": null
                },
                {
                    "descriptor": "0.0.TEXTA315",
                    "column": "AnnotationP2En",
                    "column_id": 14,
                    "value": "No subdivisions relevant for this standard.",
                    "unit": null
                },
                {
                    "descriptor": "0.0.TEXTA315",
                    "column": "AnnotationP3En",
                    "column_id": 15,
                    "value": "French Southern and Antarctic Territories (FQ, ATF, --) are now part of Antarctica and French Southern Territories (TF, ATF, 260). See also code element FQHH. Dronning Maud Land (NQ, ATN, 216) is now part of Antarctica. See also code element NQAQ.",
                    "unit": null
                },
                {
                    "descriptor": "0.0.RCRDD344",
                    "column": "CountryId",
                    "column_id": 1,
                    "value": "1",
                    "unit": null
                },
                {
                    "descriptor": "0.0.MAREA519",
                    "column": "NumericCode",
                    "column_id": 2,
                    "value": "10",
                    "unit": null
                }
            ]
        },
        {
            "id": 2,
            "timestamp": "2020",
            "data": [
                {
                    "descriptor": "0.0.SHRTC3",
                    "column": "ShortName",
                    "column_id": 4,
                    "value": "BULGARIA",
                    "unit": null
                },
                {
                    "descriptor": "0.0.LPHCN4",
                    "column": "Alpha2Code",
                    "column_id": 6,
                    "value": "BG",
                    "unit": null
                },
                {
                    "descriptor": "0.0.LPHCN5",
                    "column": "Alpha3Code",
                    "column_id": 7,
                    "value": "BGR",
                    "unit": null
                },
                {
                    "descriptor": "0.0.SHRTC10",
                    "column": "ShortNameLcEn",
                    "column_id": 5,
                    "value": "Bulgaria",
                    "unit": null
                },
                {
                    "descriptor": "0.0.TEXTA315",
                    "column": "Status",
                    "column_id": 11,
                    "value": "Officially assigned",
                    "unit": null
                },
                {
                    "descriptor": "0.0.TEXTA315",
                    "column": "FullName",
                    "column_id": 3,
                    "value": "the Republic of Bulgaria",
                    "unit": null
                },
                {
                    "descriptor": "0.0.RCRDD344",
                    "column": "CountryId",
                    "column_id": 1,
                    "value": "2",
                    "unit": null
                },
                {
                    "descriptor": "0.0.MAREA519",
                    "column": "NumericCode",
                    "column_id": 2,
                    "value": "100",
                    "unit": null
                }
            ]
        },
        {
            "id": 3,
            "timestamp": "2020",
            "data": [
                {
                    "descriptor": "0.0.SHRTC3",
                    "column": "ShortName",
                    "column_id": 4,
                    "value": "MYANMAR",
                    "unit": null
                },
                {
                    "descriptor": "0.0.LPHCN4",
                    "column": "Alpha2Code",
                    "column_id": 6,
                    "value": "MM",
                    "unit": null
                },
                {
                    "descriptor": "0.0.LPHCN5",
                    "column": "Alpha3Code",
                    "column_id": 7,
                    "value": "MMR",
                    "unit": null
                },
                {
                    "descriptor": "0.0.SHRTC10",
                    "column": "ShortNameLcEn",
                    "column_id": 5,
                    "value": "Myanmar",
                    "unit": null
                },
                {
                    "descriptor": "0.0.TEXTA315",
                    "column": "Status",
                    "column_id": 11,
                    "value": "Officially assigned",
                    "unit": null
                },
                {
                    "descriptor": "0.0.TEXTA315",
                    "column": "FullName",
                    "column_id": 3,
                    "value": "the Republic of the Union of Myanmar",
                    "unit": null
                },
                {
                    "descriptor": "0.0.TEXTA315",
                    "column": "AnnotationP2En",
                    "column_id": 14,
                    "value": "Remark: the forms used in the list are English-language forms provided by Myanmar.",
                    "unit": null
                },
                {
                    "descriptor": "0.0.TEXTA315",
                    "column": "AnnotationP3En",
                    "column_id": 15,
                    "value": "Name changed from former Burma (BU, BUR, 104) to Myanmar (MM MMR, 104). See code element BUMM.",
                    "unit": null
                },
                {
                    "descriptor": "0.0.RCRDD344",
                    "column": "CountryId",
                    "column_id": 1,
                    "value": "3",
                    "unit": null
                },
                {
                    "descriptor": "0.0.MAREA519",
                    "column": "NumericCode",
                    "column_id": 2,
                    "value": "104",
                    "unit": null
                }
            ]
        }
    ],
    "first_page_url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=1",
    "from": 1,
    "last_page": 97,
    "last_page_url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=97",
    "links": [
        {
            "url": null,
            "label": "&laquo; Previous",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=1",
            "label": "1",
            "active": true
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=2",
            "label": "2",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=3",
            "label": "3",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=4",
            "label": "4",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=5",
            "label": "5",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=6",
            "label": "6",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=7",
            "label": "7",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=8",
            "label": "8",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=9",
            "label": "9",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=10",
            "label": "10",
            "active": false
        },
        {
            "url": null,
            "label": "...",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=96",
            "label": "96",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=97",
            "label": "97",
            "active": false
        },
        {
            "url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=2",
            "label": "Next &raquo;",
            "active": false
        }
    ],
    "next_page_url": "https://app.pollinatorhub.eu/api/v1/parts/1/data?page=2",
    "path": "https://app.pollinatorhub.eu/api/v1/parts/1/data",
    "per_page": 3,
    "prev_page_url": null,
    "to": 3,
    "total": 291
}
 

Request   

GET api/v1/parts/{part_id}/data

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

part_id   integer   

The ID of the Dataset Part. Example: 1

Query Parameters

page   integer  optional  

Chose the number of the page. Default 1.

limit   integer  optional  

Chose the number of records to return per page (max 1000). Default 1000. Example: 3

Response

Response Fields

records   object[]   

List of Records.

*   object   
id   integer   

The record ID.

timestamp   string   

Timestamp this record was recorded at.

data   object[]   

List of data contained within the Record.

*   object   
descriptor   string   

The UID of the descriptor this datum represents.

value      

The value of the datum.

unit      

The UID of the Unit, this datum is related to. Can be null.

Store Data

requires authentication

Store a set of records within provided Dataset Part.

Example request:
curl --request POST \
    "https://app.pollinatorhub.eu/api/v1/parts/1/data" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"records\": [
        {
            \"timestamp\": \"2022-09-27 15:00:00\",
            \"data\": [
                {
                    \"descriptor\": \"0.0.NTSCD55\",
                    \"value\": \"BE100\",
                    \"unit\": \"kg\"
                }
            ]
        }
    ]
}"
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1/data';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'records' => [
                [
                    'timestamp' => '2022-09-27 15:00:00',
                    'data' => [
                        [
                            'descriptor' => '0.0.NTSCD55',
                            'value' => 'BE100',
                            'unit' => 'kg',
                        ],
                    ],
                ],
            ],
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/parts/1/data"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "records": [
        {
            "timestamp": "2022-09-27 15:00:00",
            "data": [
                {
                    "descriptor": "0.0.NTSCD55",
                    "value": "BE100",
                    "unit": "kg"
                }
            ]
        }
    ]
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/parts/1/data'
payload = {
    "records": [
        {
            "timestamp": "2022-09-27 15:00:00",
            "data": [
                {
                    "descriptor": "0.0.NTSCD55",
                    "value": "BE100",
                    "unit": "kg"
                }
            ]
        }
    ]
}
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{}
 

Request   

POST api/v1/parts/{part_id}/data

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

part_id   integer   

The ID of the Dataset Part. Example: 1

Body Parameters

records   object[]   

A list of records (rows) to be uploaded.

timestamp   string   

Time of measurement in ISO 8601 timestamp. Example: 2022-09-27 15:00:00

data   object[]   

A list of columns to insert. Must have at least 1 items.

descriptor   string   

UID of the descriptor. Example: 0.0.NTSCD55

Must be one of:
  • 0.0.SHRTC3
  • 0.0.LPHCN4
  • 0.0.LPHCN5
  • 0.0.SHRTC10
  • 0.0.STRTR14
  • 0.0.NDDTE15
  • PHRFR27.LCNCS36.DNTFR21
  • PHRFR27.LCNCS36.BBRVT22
  • PHRFR27.LCNCS36.SLUGA23
  • PHRFR27.LCNCS36.LCNCD24
  • PHRFR27.LCNCS36.LCNCN25
  • PHRFR27.LCNCS36.LCNCD26
  • PHRFR27.LCNCS36.XTRNL27
  • PHRFR27.LCNCS36.XTRNL28
  • PHRFR27.LCNCS36.VLBLT29
  • PHRFR27.LCNCS36.CRTDT30
  • PHRFR27.LCNCS36.PDTDT31
  • PHRFR27.LCNCS36.DLTDT32
  • 0.0.HVWGH33
  • 0.0.RCRDN34
  • 0.0.RCRDC35
  • NUTSA3.RNITS37.NTSLV37
  • NUTSA3.RNITS37.NTSLV38
  • NUTSA3.RNITS37.NTSLV39
  • NUTSA3.RNITS37.NTSLV40
  • NUTSA3.RNITS37.NTSLV41
  • NUTSA3.RNITS37.NTSLV42
  • NUTSA3.RNITS37.CLUMN43
  • NUTSA3.RNITS37.CLUMN44
  • NUTSA3.NTSBR38.DNTFR45
  • NUTSA3.NTSBR38.DSCRP46
  • NUTSA3.NTSCS39.DNTFR47
  • NUTSA3.NTSCS39.DSCRP48
  • NUTSA3.NTSMN40.DNTFR49
  • NUTSA3.NTSMN40.DSCRP50
  • NUTSA3.NTSRM41.DNTFR51
  • NUTSA3.NTSRM41.DSCRP52
  • NUTSA3.NTSRB42.DNTFR53
  • NUTSA3.NTSRB42.DSCRP54
  • 0.0.NTSCD55
  • NUTSA3.NUTSA43.NAMEA56
  • NUTSA3.NUTSA43.NMNLT57
  • NUTSA3.NUTSA43.LEVEL58
  • NUTSA3.NUTSA43.VRSNA59
  • NUTSA3.NUTSA43.SMTRP61
  • NUTSA3.NUTSA43.MTRPL62
  • NUTSA3.NUTSA43.MTRPL63
  • NUTSA3.NUTSA43.SSLND67
  • NUTSA3.NUTSA43.VLDFR69
  • NUTSA3.NUTSA43.VLDTO70
  • NUTSA3.LAUAB44.DNTFR71
  • 0.0.LCODE73
  • NUTSA3.LAUAB44.NAMEA74
  • NUTSA3.LAUAB44.NMNLT75
  • CRRNC5.ISOAB3.IDABC76
  • CRRNC5.ISOAB3.NTTYN78
  • CRRNC5.ISOAB3.CRRNC79
  • CRRNC5.ISOAB3.LPHBT80
  • CRRNC5.ISOAB3.NMRCC81
  • CRRNC5.ISOAB3.MNRNT82
  • CRRNC5.ISOAB3.DFNTN83
  • CRRNC5.ISOAB3.WTHDR84
  • CRRNC5.ISOAB3.DTPBL85
  • 0.0.NITID86
  • 0.0.NTNME87
  • 0.0.UNITA94
  • LNGGE20.LNGGS45.SLPHD98
  • LNGGE20.LNGGS45.NTNME99
  • LNGGE20.LNGGS45.FFCLL100
  • LNGGE20.LNGGS45.PRCDR101
  • LNGGE20.ISOAB46.SLPHD102
  • LNGGE20.ISOAB46.SLPHD103
  • LNGGE20.ISOAB46.SLPHD104
  • LNGGE20.ISOAB46.NAMEA105
  • LNGGE20.ISOAB46.FRNCH106
  • 0.0.LPHLN107
  • LNGGE20.ISOAB47.SLPHD108
  • LNGGE20.ISOAB47.SLPHD109
  • 0.0.LPHLN110
  • LNGGE20.ISOAB47.SCOPE111
  • LNGGE20.ISOAB47.TYPEA112
  • LNGGE20.ISOAB47.RFRNC113
  • LNGGE20.ISOAB47.CMMNT114
  • LNGGE20.SMCRL48.MCRLN115
  • LNGGE20.SMCRL48.LNGGD116
  • LNGGE20.SMCRL48.STTSC117
  • LNGGE20.SNMES49.DNTFR118
  • LNGGE20.SNMES49.SLPHD119
  • LNGGE20.SNMES49.PRNTN120
  • LNGGE20.SNMES49.NVRTD121
  • LNGGE20.SRTRM50.SLPHD122
  • LNGGE20.SRTRM50.LNGGN123
  • LNGGE20.SRTRM50.RTRMN124
  • LNGGE20.SRTRM50.CHNGT125
  • LNGGE20.SRTRM50.RTRMN126
  • LNGGE20.SRTRM50.FFCTV127
  • 0.0.PLTCL128
  • DVSNS29.PLDST51.PLTCL129
  • DVSNS29.PLDST51.DSCRP130
  • DVSNS29.PLDST51.SRCDA131
  • 0.0.MNCPL132
  • DVSNS29.LSTAT52.MNCPL133
  • DVSNS29.LSTAT52.LAUAB134
  • DVSNS29.LSTAT52.PSTCD135
  • DVSNS29.LSTAT52.NUTSA136
  • DVSNS29.LSTAT52.PLTCL137
  • DVSNS29.LSTAT52.PLTCL138
  • DVSNS29.LSTAT52.SRCDA139
  • 0.0.LNDWR140
  • DVSNS29.HPGAB53.DSCRP141
  • DVSNS29.HPGAB53.SRCDA142
  • DVSNS29.0.KPGAB143
  • DVSNS29.0.DSCRP144
  • DVSNS29.0.SRCDA145
  • DVSNS29.LTLPG55.MNCPL146
  • DVSNS29.LTLPG55.HPGAB147
  • DVSNS29.LTLPG55.KPGAB148
  • DVSNS29.LTLPG55.SRCDA149
  • HNYPR6.0.IDABC150
  • HNYPR6.0.YEARA151
  • HNYPR6.0.BKPER152
  • HNYPR6.0.PIARY153
  • HNYPR6.0.HNYYL154
  • HNYPR6.0.NUTSA155
  • HNYPR6.0.HPGAB156
  • 0.0.LCTND157
  • 0.0.CNTRY159
  • 0.0.HVEID216
  • 0.0.HNYBS223
  • 0.0.SCNTN256
  • 0.0.NTGER313
  • 0.0.DCMLN314
  • 0.0.TEXTA315
  • 0.0.BLEAN316
  • 0.0.DATEA317
  • 0.0.TIMEA318
  • 0.0.DTNDT319
  • 0.0.CRDNT330
  • PHRFR27.0.IMAGE331
  • 0.0.LNGTD332
  • 0.0.LTTDE333
  • 0.0.FTPRN334
  • 0.0.DTSTD335
  • 0.0.GBFTX336
  • 0.0.DTSTN337
  • 0.0.YEARA340
  • 0.0.HNYPR341
  • 0.0.PRYID342
  • 0.0.BKPRD343
  • 0.0.RCRDD344
  • 0.0.MCODE356
  • 0.0.CLNYD362
  • BKPNG8.0.DMNCD363
  • BKPNG8.0.LMNTC364
  • BKPNG8.0.TMCDE365
  • BKPNG8.0.YRIDA366
  • BKPNG8.0.NITID367
  • BKPNG8.0.FLGID368
  • BKPNG8.0.SRCDA369
  • BKPNG8.0.MNTHD370
  • 0.0.NMBRF371
  • BKPNG8.0.CTVNG372
  • BKPNG8.0.CTVNG373
  • BKPNG8.0.SRCHT374
  • 0.0.HNYBD375
  • 0.0.CLNDR376
  • VTCSS14.0.SRCDA377
  • 0.0.PSTCD378
  • VTCSS14.0.CSNMB379
  • 0.0.NVRSL380
  • 0.0.DAYAB382
  • 0.0.HRFDY386
  • PLLNT11.CRPGG73.CRPID388
  • 0.0.CSRGS389
  • 0.0.CDFTH390
  • 0.0.CPCCD391
  • 0.0.PHCDE392
  • 0.0.HGHTB393
  • 0.0.TMPRT394
  • 0.0.RLTVH395
  • 0.0.TMSPH396
  • BSCLD32.0.TRTMN397
  • BSCLD32.0.RPLCT398
  • 0.0.CNCNT399
  • BSCLD32.0.WGHTT401
  • BSCLD32.0.WGHTT402
  • BSCLD32.0.XPRMN405
  • 0.0.DNTFC406
  • 0.0.DNTFC407
  • PHRFR27.0.LCNCT408
  • 0.0.BBRVT409
  • 0.0.BBRVT410
  • 0.0.ARECD411
  • 0.0.ARLBL412
  • 0.0.CLNDR414
  • 0.0.CLNDR415
  • 0.0.DMNCD416
  • 0.0.DMNLB417
  • 0.0.LMNTC418
  • 0.0.LMNTL419
  • 0.0.UNTDS420
  • 0.0.FLAGA421
  • 0.0.FLGDS422
  • 0.0.ITMCD423
  • 0.0.TMDSC424
  • 0.0.TMLBL425
  • 0.0.CPCCD426
  • 0.0.HSCDE427
  • 0.0.HSCDE428
  • 0.0.YERCD429
  • 0.0.RDSCR430
  • VOTES100.0.VTDNT431
  • VOTES100.0.MPDNT432
  • VOTES100.0.PLTCL433
  • 0.0.LMTFQ434
  • 0.0.DWCVR435
  • 0.0.DWCVR436
  • NUTSA3.RNITS37.NTSCD438
  • BRDMN101.0.TMPRT439
  • BRDMN101.0.TMPRT440
  • BRDMN101.0.TMPRT441
  • BRDMN101.0.TMPRT442
  • BRDMN101.0.TMPRT443
  • BRDMN101.0.TMPRT444
  • BRDMN101.0.TMPRT445
  • BRDMN101.0.HMDTY446
  • BRDMN101.0.HMDTY447
  • BRDMN101.0.HMDTY448
  • BRDMN101.0.HMDTY449
  • BRDMN101.0.HMDTY450
  • BRDMN101.0.HMDTY451
  • BRDMN101.0.WGHTS452
  • BRDMN101.0.WGHTT453
  • BRDMN101.0.WGHTT454
  • BRDMN101.0.WGHTC455
  • 0.0.PIARY456
  • 0.0.NMBER457
  • 0.0.HNYYL458
  • BRDMN101.0.PRYID459
  • BRDMN101.0.SERID460
  • BRDMN101.0.LCTNA461
  • BRDMN101.0.HVEID462
  • BRDMN101.0.DVCDA463
  • 0.0.TMFDY464
  • 0.0.EMAIL465
  • 0.0.SSONA466
  • 0.0.QNTFC467
  • 0.0.VRRNF468
  • 0.0.NXTME469
  • 0.0.TCFFS470
  • 0.0.RNFLL471
  • 0.0.SNWFL472
  • 0.0.RNFLL473
  • 0.0.WNDSP474
  • 0.0.WNDDR475
  • 0.0.WNDGS476
  • 0.0.SLRRR477
  • 0.0.RTFSL478
  • HNYPL182.0.NMSRN479
  • HNYPL182.0.EMAIL480
  • HNYPL182.0.TLPHN481
  • HNYPL182.0.SSCTN482
  • 0.0.SERID483
  • 0.0.VRBTM484
  • 0.0.NMBRF485
  • 0.0.QNIDA486
  • 0.0.RGBDG487
  • 0.0.PPLNC488
  • 0.0.MTRLS489
  • 0.0.NMBRF490
  • 0.0.NMBRF491
  • 0.0.NMBRF492
  • 0.0.VNTDA493
  • 0.0.NMBRF494
  • 0.0.NMBRF495
  • 0.0.NMBRF496
  • 0.0.NMBRF497
  • 0.0.NMBRF498
  • 0.0.QNRGH499
  • 0.0.NMBRF500
  • 0.0.BFRND501
  • 0.0.BNSHB502
  • 0.0.SCNTF503
  • 0.0.NSCDE504
  • 0.0.NSLVL505
  • 0.0.NSLVL506
  • BGDBN192.SPCSC459.BGDBN192.0.0.0.CCRRN507
  • 0.0.FMILY508
  • 0.0.GENUS509
  • BGDBN192.SPCSB458.BGDBN192.0.0.0.RBSTN510
  • BGDBN192.SPCSV460.BGDBN192.0.0.0.VRGCV511
  • BGDHN193.0.VRGCV512
  • BGDHN193.0.RBSTN513
  • 0.0.CLNDR514
  • 0.0.GNBNK515
  • BGDGN199.0.PLTDA516
  • BGDGN199.0.SMPLP517
  • BGDGN200.0.PLTDA518
  • 0.0.MAREA519
  • 0.0.CNMCV520
  • 0.0.WGHTA521
  • 0.0.MJRGR522
  • 0.0.CTGRF523
  • 0.0.CDABC524
  • 0.0.PPPCH525
  • 0.0.SBSTN526
  • 0.0.ORDER527
  • 0.0.SBFML528
  • 0.0.TRIBE529
  • 0.0.SBGNS530
  • 0.0.DNTFD531
  • 0.0.SPCFC532
  • 0.0.NFRSP533
  • 0.0.SEXAB534
  • 0.0.RCRDD535
  • 0.0.DNTFD536
  • 0.0.DTDNT537
  • 0.0.VRBTM538
  • 0.0.SMPLN539
  • 0.0.HGHRG540
  • 0.0.STTPR541
  • 0.0.CUNTY542
  • 0.0.MNCPL543
  • 0.0.LCLTY544
  • 0.0.MDFDA545
  • 0.0.CCRRN546
  • 0.0.DWCTY547
  • 0.0.LNGGE548
  • 0.0.DTFLW549
  • 0.0.LSTPD550
  • 0.0.PDTFR551
  • 0.0.TMLBL552
  • 0.0.TMCDA553
  • 0.0.FRQNC554
  • 0.0.TTLLB555
  • 0.0.FLGAB556
  • 0.0.DWCNS557
  • 0.0.NFLTN558
  • 0.0.CCPHC559
  • 0.0.CCPHL560
  • 0.0.NTCDE561
  • 0.0.NTLBL562
  • 0.0.NMBRF563
  • 0.0.LCNSE564
  • 0.0.RGHTS565
  • 0.0.CCSSR566
  • 0.0.BBLGR567
  • 0.0.RFRNC568
  • 0.0.CLLCT569
  • 0.0.NSTTT570
  • 0.0.WNRNS571
  • 0.0.BSSFR572
  • 0.0.DYNMC573
  • 0.0.DTGNR574
  • 0.0.NFRMT575
  • 0.0.LNGGE576
  • 0.0.NDSCR577
  • 0.0.DNTFD578
  • 0.0.RCRDD579
  • 0.0.TTXON580
  • 0.0.NCLLC581
  • 0.0.GRFRN582
  • 0.0.GRFRN583
  • 0.0.BHVRA584
  • 0.0.BHVRA585
  • 0.0.CASTE586
  • 0.0.CASTE587
  • 0.0.DTGNR588
  • 0.0.DGRFS589
  • 0.0.DGRFS590
  • 0.0.DSPST591
  • 0.0.DSPST592
  • 0.0.GLGCL593
  • 0.0.CCRRN594
  • 0.0.RGNSM595
  • 0.0.MTRLN596
  • 0.0.MTRLS597
  • 0.0.EVENT598
  • 0.0.LCTNA599
  • 0.0.DNTFC600
  • 0.0.TAXON601
  • 0.0.MSRMN602
  • 0.0.RSRCR603
  • 0.0.LVNGS604
  • 0.0.PRSRV605
  • 0.0.FSSLS606
  • 0.0.MTRLC607
  • 0.0.HMNBS608
  • 0.0.MCHNB609
  • 0.0.RLSTG610
  • 0.0.SMPLN611
  • 0.0.DNTFC612
  • 0.0.DNTFC613
  • 0.0.CNTNN614
  • 0.0.FTPRN615
  • 0.0.GRFRN616
  • 0.0.SLAND617
  • 0.0.SLNDG618
  • 0.0.WTRBD619
  • 0.0.MSRMN620
  • 0.0.MSRMN621
  • 0.0.STBLS622
  • 0.0.STBLS623
  • 0.0.RCRDN624
  • 0.0.SEXAB625
  • 0.0.DNTFC626
  • 0.0.NMNCL627
  • 0.0.TXNID628
  • 0.0.CLLCT629
  • 0.0.NFRMT630
  • 0.0.GDTCD631
  • 0.0.GDTCD632
  • 0.0.KNGDM633
  • 0.0.PHYLM634
  • 0.0.CLASS635
  • 0.0.SPRFM636
  • 0.0.SBTRB637
  • 0.0.VTLTY638
  • 0.0.VTLTY639
  • 0.0.VRTCL640
  • 0.0.VRTCL641
  • 0.0.VRBTM642
  • 0.0.VRBTM643
  • 0.0.VRBTM644
  • 0.0.VRBTM645
  • 0.0.VRBTM646
  • 0.0.VRBTM647
  • 0.0.TYPST648
  • 0.0.TYPST649
  • 0.0.SMPLS650
  • 0.0.SMPLS651
  • 0.0.SMPLS652
  • 0.0.RPRDC653
  • 0.0.RPRDC654
  • 0.0.PRPRT655
  • 0.0.PRPRT656
  • 0.0.PTHWY657
  • 0.0.PTHWY658
  • 0.0.RGNSM659
  • 0.0.RGNSM660
  • 0.0.RGNSM661
  • 0.0.CCRRN662
  • 0.0.CCRRN663
  • 0.0.MSRMN664
  • 0.0.MSRMN665
  • 0.0.MSRMN666
  • 0.0.MSRMN667
  • 0.0.MSRMN668
  • 0.0.MSRMN669
  • 0.0.MSRMN670
  • 0.0.MSRMN671
  • 0.0.LCTNC672
  • 0.0.LCTNC673
  • 0.0.LFSTG674
  • 0.0.LFSTG675
  • 0.0.LTSTG676
  • 0.0.NDTST677
  • 0.0.HBTAT678
  • 0.0.HBTAT679
  • 0.0.GRFRN680
  • 0.0.GRFRN681
  • 0.0.GRFRN682
  • 0.0.GRFRN683
  • 0.0.GRFRN684
  • 0.0.GRFRN685
  • 0.0.FRMLT686
  • 0.0.FTPRN687
  • 0.0.FTPRN688
  • 0.0.FLDNM689
  • 0.0.FLDNM690
  • 0.0.FLDNT691
  • 0.0.FLDNT692
  • 0.0.VNTTY693
  • 0.0.VNTTY694
  • 0.0.CCRRN695
  • 0.0.THRCT696
  • 0.0.SSCTD697
  • 0.0.SSCTD698
  • 0.0.SSCTD699
  • 0.0.SSCTD700
  • 0.0.NDVDL701
  • 0.0.RCRDD702
  • 0.0.CTLGN703
  • 0.0.RGNSM704
  • 0.0.PRVSD705
  • 0.0.SSCTD706
  • 0.0.RGNSM707
  • 0.0.RGNSM708
  • 0.0.RGNSM709
  • 0.0.MTRLN710
  • 0.0.SSCTD711
  • 0.0.VRBTM712
  • 0.0.MTRLN713
  • 0.0.VNTRM714
  • 0.0.SMPLN715
  • 0.0.PRNTV716
  • 0.0.MONTH717
  • 0.0.STRTD718
  • 0.0.NDDYF719
  • 0.0.VNTTM720
  • 0.0.VNTDT721
  • 0.0.GRFRN722
  • 0.0.FTPRN723
  • 0.0.PNTRD724
  • 0.0.CRDNT725
  • 0.0.CRDNT726
  • 0.0.LCTNR727
  • 0.0.MXMMD728
  • 0.0.MNMMD729
  • 0.0.VRBTM730
  • 0.0.MXMMD731
  • 0.0.MNMMD732
  • 0.0.MXMML733
  • 0.0.MNMML734
  • 0.0.VRBTM735
  • 0.0.CNTRY736
  • 0.0.HGHRG737
  • 0.0.BEDAB738
  • 0.0.MMBER739
  • 0.0.FRMTN740
  • 0.0.GROUP741
  • 0.0.LTHST742
  • 0.0.HGHST743
  • 0.0.LWSTB744
  • 0.0.LTSTG745
  • 0.0.RLSTG746
  • 0.0.LTSTP747
  • 0.0.RLSTP748
  • 0.0.LTSTP749
  • 0.0.RLSTP750
  • 0.0.LTSTR751
  • 0.0.RLSTR752
  • 0.0.LTSTN753
  • 0.0.RLSTN754
  • 0.0.DNTFC755
  • 0.0.DNTFC756
  • 0.0.TXNRM757
  • 0.0.NMNCL758
  • 0.0.TXNMC759
  • 0.0.VRNCL760
  • 0.0.VRBTM761
  • 0.0.TXNRN762
  • 0.0.CLTVR763
  • 0.0.NFRGN764
  • 0.0.GNRCN765
  • 0.0.HGHRC766
  • 0.0.NMPBL767
  • 0.0.NMPBL768
  • 0.0.NMCCR769
  • 0.0.TXNCN770
  • 0.0.CCPTD771
  • 0.0.CCPTD772
  • 0.0.RGNLN773
  • 0.0.NMCCR774
  • 0.0.PRNTN775
  • 0.0.NMPBL776
  • 0.0.RGNLN777
  • 0.0.PRNTN778
  • 0.0.SCNTF779
  • 0.0.MSRMN780
  • 0.0.MSRMN781
  • 0.0.MSRMN782
  • 0.0.PRNTM783
  • 0.0.MSRMN784
  • 0.0.RLTNS785
  • 0.0.RLTNS786
  • 0.0.RLTNS787
  • 0.0.RLTNS788
  • 0.0.RLTDR789
  • 0.0.RSRCD790
  • 0.0.RLTNS791
  • 0.0.RSRCR792
  • 0.0.MNTHC793
  • 0.0.MNTHD794
  • PLLNT11.0.PLLNT11.0.0.0.MGEID795
  • 0.0.GDPCR796
  • 0.0.GDPCN797
  • 0.0.STRTM798
  • 0.0.NDMNT799
  • 0.0.STRTD800
  • 0.0.NDDAY801
  • 0.0.MTRLS802
  • 0.0.DTBSN803
  • 0.0.DTPRV804
  • 0.0.STRTD805
  • 0.0.NDDTE806
  • 0.0.NDDTT807
  • 0.0.STRTD808
  • 0.0.STRTT809
  • 0.0.STRTT810
  • 0.0.NDTRN811
  • 0.0.NDTRN812
  • 0.0.TRNSC813
  • 0.0.GGRGT814
  • 0.0.CLDCV815
  • 0.0.BFRTF816
  • 0.0.NDLCL817
  • 0.0.STRTL818
  • 0.0.GLGCL819
  • 0.0.VRAGE820
  • 0.0.MDIAN821
  • 0.0.SMPLV822
  • 0.0.PPLTN823
  • 0.0.SEMAB824
  • 0.0.SDABC825
  • 0.0.NTRQR826
  • 0.0.CFFCN827
  • 0.0.RANGE828
  • 0.0.NMBRF829
  • 0.0.NMBRF830
  • 0.0.PCRCY831
  • 0.0.MAXAB832
  • 0.0.MINAB833
  • 0.0.HRTBL834
  • 0.0.PRCNT835
  • 0.0.SKWNS836
  • 0.0.SUMAB837
  • 0.0.VRBLS838
  • 0.0.FSDCF839
  • 0.0.FSDCF840
  • 0.0.LPHCN841
  • 0.0.RCRDR842
  • 0.0.FRMTP843
  • 0.0.FRMDM844
  • 0.0.HVTMP845
  • 0.0.PPLNC846
  • 0.0.SNSRD847
  • 0.0.SNSRN848
  • 0.0.NSDNT849
  • 0.0.SNITA850
  • 0.0.PHBTC851
  • 0.0.NMRCC852
  • 0.0.MXMMM853
  • 0.0.MNMMM854
  • 0.0.PPDBD855
  • 0.0.PPDBS856
  • 0.0.CNMBR857
  • 0.0.PPDBP858
  • 0.0.CTRLT859
  • 0.0.CTCNT860
  • 0.0.SCNTF861
  • 0.0.SCNTF862
  • 0.0.DTSTT863
  • 0.0.DTSTT864
  • 0.0.DTSTC865
  • 0.0.DTSTC866
  • 0.0.NTSCD868
  • 0.0.DSSEA869
value   string   

The value of the column. Must be at least 1 character. Example: BE100

unit   string  optional  

Optionally the name of the unit the value is provided in. By skipping this value a default is used based on the column type. Example: kg

Must be one of:
  • n.a.
  • %
  • % of total LSU
  • trillion EUR
  • billion EUR
  • million EUR
  • thousand EUR
  • EUR
  • EUR/kg
  • trillion USD
  • billion USD
  • million USD
  • thousand USD
  • USD
  • USD/m3
  • LCU
  • LCU/1000 kcal
  • LCU/J
  • LCU/t
  • LCU/kg
  • LCU/person/day
  • SLC
  • 1000 I$
  • I$
  • I$/person
  • units/100 km2 land area
  • units/ha land area
  • km
  • m
  • dm
  • cm
  • mm
  • μm
  • nm
  • 1000 ha
  • ha
  • m2
  • dm2
  • cm2
  • mm2
  • L
  • m3
  • 1000 head
  • head
  • no./animal
  • million no.
  • thousand no.
  • no.
  • billion no.
  • 1000 person
  • person
  • index
  • 2u
  • 12u
  • 1000u
  • u
  • U (jeu/pack)
  • kcal/capita/day
  • J/capita/day
  • million kcal
  • kcal
  • Terajoule
  • 1000 kWh
  • kWh
  • joule
  • electronvolt
  • watt
  • °C
  • Varroa mites/day
  • km/h
  • m/s
  • m/s2
  • year
  • month
  • week
  • day
  • hour
  • minute
  • second
  • 100 mg/animal
  • hg/animal
  • mg/animal
  • hg/t
  • t/ha
  • hg/ha
  • kg/ha
  • kg/person
  • kg nutrients
  • g CH4/kg dry matter
  • kg CH4/head
  • g N2O/kg dry matter
  • kg N2O-N/ha
  • kg N2O-N/kg N
  • kg CO2eq/kg product
  • g/capita/day
  • Mt
  • kt
  • t
  • kg
  • hg
  • dag
  • g
  • mg
  • ng
  • carat
  • degree
  • angle minute
  • angle second
  • radian
  • steradian
  • ampere
  • volt
  • farad
  • ohm
  • siemens
  • mole
  • mole/m3
  • kelvin
  • hertz
  • newton
  • pascal
  • lux
  • becquerel
  • sievert
  • katal
  • kg/m3
  • m3/kg
  • candela
  • W/m2
  • cd/m2
  • coulomb
  • weber
  • tesla
  • henry
  • lumen
  • gray
  • /m
  • kg/m2
  • A/m2
  • A/m
  • Pa s
  • N m
  • N/m
  • rad/s
  • rad/s2
  • J/K
  • J/(K kg)
  • J/kg
  • W/(K m)
  • J/m3
  • V/m
  • C/m3
  • C/m2
  • F/m
  • H/m
  • J/mol
  • J/(K mol)
  • C/kg
  • Gy/s
  • W/sr
  • W/(sr m2)
  • kat/m3
  • astronomical unit
  • dalton
  • neper
  • bel
  • decibel
  • ADP
  • AED
  • AFA
  • AFN
  • ALK
  • ALL
  • AMD
  • ANG
  • AOA
  • AOK
  • AON
  • AOR
  • ARA
  • ARP
  • ARS
  • ARY
  • ATS
  • AUD
  • AWG
  • AYM
  • AZM
  • AZN
  • BAD
  • BAM
  • BBD
  • BDT
  • BEC
  • BEF
  • BEL
  • BGJ
  • BGK
  • BGL
  • BGN
  • BHD
  • BIF
  • BMD
  • BND
  • BOB
  • BOP
  • BOV
  • BRB
  • BRC
  • BRE
  • BRL
  • BRN
  • BRR
  • BSD
  • BTN
  • BUK
  • BWP
  • BYB
  • BYN
  • BYR
  • BZD
  • CAD
  • CDF
  • CHC
  • CHE
  • CHF
  • CHW
  • CLF
  • CLP
  • CNY
  • COP
  • COU
  • CRC
  • CSD
  • CSJ
  • CSK
  • CUC
  • CUP
  • CVE
  • CYP
  • CZK
  • DDM
  • DEM
  • DJF
  • DKK
  • DOP
  • DZD
  • ECS
  • ECV
  • EEK
  • EGP
  • ERN
  • ESA
  • ESB
  • ESP
  • ETB
  • FIM
  • FJD
  • FKP
  • FRF
  • GBP
  • GEK
  • GEL
  • GHC
  • GHP
  • GHS
  • GIP
  • GMD
  • GNE
  • GNF
  • GNS
  • GQE
  • GRD
  • GTQ
  • GWE
  • GWP
  • GYD
  • HKD
  • HNL
  • HRD
  • HRK
  • HTG
  • HUF
  • IDR
  • IEP
  • ILP
  • ILR
  • ILS
  • INR
  • IQD
  • IRR
  • ISJ
  • ISK
  • ITL
  • JMD
  • JOD
  • JPY
  • KES
  • KGS
  • KHR
  • KMF
  • KPW
  • KRW
  • KWD
  • KYD
  • KZT
  • LAJ
  • LAK
  • LBP
  • LKR
  • LRD
  • LSL
  • LSM
  • LTL
  • LTT
  • LUC
  • LUF
  • LUL
  • LVL
  • LVR
  • LYD
  • MAD
  • MDL
  • MGA
  • MGF
  • MKD
  • MLF
  • MMK
  • MNT
  • MOP
  • MRO
  • MRU
  • MTL
  • MTP
  • MUR
  • MVQ
  • MVR
  • MWK
  • MXN
  • MXP
  • MXV
  • MYR
  • MZE
  • MZM
  • MZN
  • NAD
  • NGN
  • NIC
  • NIO
  • NLG
  • NOK
  • NPR
  • NZD
  • OMR
  • PAB
  • PEH
  • PEI
  • PEN
  • PES
  • PGK
  • PHP
  • PKR
  • PLN
  • PLZ
  • PTE
  • PYG
  • QAR
  • RHD
  • ROK
  • ROL
  • RON
  • RSD
  • RUB
  • RWF
  • SAR
  • SBD
  • SCR
  • SDD
  • SDG
  • SDP
  • SEK
  • SGD
  • SHP
  • SIT
  • SKK
  • SLE
  • SLL
  • SOS
  • SRD
  • SRG
  • SSP
  • STD
  • STN
  • SUR
  • SVC
  • SYP
  • SZL
  • THB
  • TJR
  • TJS
  • TMM
  • TMT
  • TND
  • TOP
  • TPE
  • TRL
  • TRY
  • TTD
  • TWD
  • TZS
  • UAH
  • UAK
  • UGS
  • UGW
  • UGX
  • USN
  • USS
  • UYI
  • UYN
  • UYP
  • UYU
  • UYW
  • UZS
  • VEB
  • VED
  • VEF
  • VES
  • VNC
  • VND
  • VUV
  • WST
  • XAF
  • XAG
  • XAU
  • XBA
  • XBB
  • XBC
  • XBD
  • XCD
  • XDR
  • XEU
  • XFO
  • XFU
  • XOF
  • XPD
  • XPF
  • XPT
  • XRE
  • XSU
  • XTS
  • XUA
  • XXX
  • YDD
  • YER
  • YUD
  • YUM
  • YUN
  • ZAL
  • ZAR
  • ZMK
  • ZMW
  • ZRN
  • ZRZ
  • ZWC
  • ZWD
  • ZWL
  • ZWN
  • ZWR
  • hectopascal
  • g/m3
  • mg/L
  • ng/L
  • ug/L
  • ft
  • °F
  • no./day
  • Varroa mites/100 bees
  • spores per animal
  • mm/h
  • J/m2
  • J/cm2
  • dBm
  • mm3
  • °Bx
  • bp
  • AWUs
  • thousand AWUs
  • thousand spores per animal
  • million spores per animal
  • billion spores per animal

Delete all Data

requires authentication

Removes all data related to this Dataset Part.

Example request:
curl --request DELETE \
    "https://app.pollinatorhub.eu/api/v1/parts/1/data" \
    --header "Authorization: Bearer {YOUR_AUTH_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
$client = new \GuzzleHttp\Client();
$url = 'https://app.pollinatorhub.eu/api/v1/parts/1/data';
$response = $client->delete(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_AUTH_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
const url = new URL(
    "https://app.pollinatorhub.eu/api/v1/parts/1/data"
);

const headers = {
    "Authorization": "Bearer {YOUR_AUTH_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "DELETE",
    headers,
}).then(response => response.json());
import requests
import json

url = 'https://app.pollinatorhub.eu/api/v1/parts/1/data'
headers = {
  'Authorization': 'Bearer {YOUR_AUTH_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('DELETE', url, headers=headers)
response.json()

Example response (204):

Empty response
 

Request   

DELETE api/v1/parts/{part_id}/data

Headers

Authorization      

Example: Bearer {YOUR_AUTH_KEY}

Content-Type      

Example: application/json

Accept      

Example: application/json

URL Parameters

part_id   integer   

The ID of the Dataset Part. Example: 1

Body Parameters

records   object  optional  

Must not have more than 500 items.