Download labels

Download labels

Download all labels

URL

GET https://tools.deepen.ai/api/v2/datasets/{datasetId}/labels?filter_existing_categories=true&final=true

Request

Path parameters

Parameter name	Parameter type	Description
datasetId	string	Dataset Id of the dataset

Response

Returns a json with the field ‘all_labels’ that represents an array of all the labels in the dataset.

Example

{
    "all_labels": [
        {
            "file_id": "20190412_092019_002Img1_338613.pcd",
            "label_category_id": "car",
            "label_id": "car: 4",
            "label_type": "3d_bbox",
            "stage_id": "QA",
            "create_time_millis": 1589965718592,
            "label_set_id": "default",
            "labeller_email": "[e-mail]",
            "sensor_id": "lidar",
            "three_d_bbox": {
                "cx": 4.664568330379911,
                "cy": 6.061948311705668,
                "cz": 1.0518338639631983,
                "h": 2.25,
                "l": 2.25,
                "w": 2.25,
                "rot_z": 0
            },
            "update_time_millis": 1589965718592,
            "version": 1
        }
    ]
}

Download labels by filename

URL

GET https://tools.deepen.ai/api/v2/datasets/{datasetId}/labels?labels_with_file_ids_order=true&final=true

Request

Path parameters

Parameter name	Parameter type	Description
datasetId	string	Dataset Id of the dataset

Response

Returns a json with the field ‘labels’ that represents a dictionary of labels and files.

Example

{
    "labels": {
        "20190412_092019_002Img1_338613.pcd": [
            {
                "file_id": "20190412_092019_002Img1_338613.pcd",
                "label_category_id": "car",
                "label_id": "car:4",
                "label_type": "3d_bbox",
                "stage_id": "QA",
                "create_time_millis": 1589965718592,
                "label_set_id": "default",
                "labeller_email": "[e-mail]",
                "sensor_id": "lidar",
                "three_d_bbox": {
                    "cx": 4.664568330379911,
                    "cy": 6.061948311705668,
                    "cz": 1.0518338639631983,
                    "h": 2.25,
                    "l": 2.25,
                    "w": 2.25,
                    "rot_z": 0
                },
                "update_time_millis": 1589965718592,
                "version": 1
            }
        ],
        "20190412_092019_002Img1_338663.pcd": [],
        "20190412_092019_002Img1_338713.pcd": [],
        "20190412_092019_002Img1_338763.pcd": [],
        "20190412_092019_002Img1_338813.pcd": [],
        "20190412_092019_002Img1_338863.pcd": [],
        "20190412_092019_002Img1_338913.pcd": [],
        "20190412_092019_002Img1_338963.pcd": [],
        "20190412_092019_002Img1_339013.pcd": [],
        "20190412_092019_002Img1_339062.pcd": []
    }
}

Note: Labels can only be downloaded after the completion of labelling.