Items

List items

Changed on Nov 3, 2026

Returns list of Items given provided filters.

get/api/v2/teams/{team_slug}/items

Request

Base URL
https://darwin.v7labs.com
URL
https://darwin.v7labs.com/api/v2/teams/{team_slug}/items
Auth
- HTTP bearer
- or API key in header Authorization

Path parameters

team_slugstring required

Team's sluggified name

Query parameters

CommonDatasetId[] required

List of dataset IDs

'all' required

All dataset IDs.

string required

[ DEPRECATED ] Comma seperated list of dataset IDs

[
  123
]

has_commentsboolean

Controls whether to include only items with/without comments

select_allboolean

For batch operation this filter has to be set to true if no other optional filter is provided.

Example:true

item_path_prefixstring

Item's path prefix to match. This filter only matches on full path segments, it's not possible to match on e.g. '/some_path' with '/some' filter.

Example:/some/prefix

not_item_path_prefixstring

Item's path prefix to match. This filter only matches on full path segments, it's not possible to match on e.g. '/some_path' with '/some' filter.

Example:/some/prefix

DatasetsV2FiltersItemPath[]

List of Item's path

string

[ DEPRECATED ] Comma separated list of Item's path

[
  "/some/path"
]

DatasetsV2FiltersItemPath[]

List of Item's path

string

[ DEPRECATED ] Comma separated list of Item's path

[
  "/some/path"
]

DatasetsV2FiltersItemId[]

List of Item's UUID

string

[ DEPRECATED ] Comma separated list of Item's UUID

[
  "e23ff3f3-8f77-4e78-9e81-fdb25abfb781"
]

DatasetsV2FiltersItemId[]

List of Item's UUID

string

[ DEPRECATED ] Comma separated list of Item's UUID

[
  "e23ff3f3-8f77-4e78-9e81-fdb25abfb781"
]

DatasetsV2FiltersItemName[]

List of Item's name

string

[ DEPRECATED ] Comma separated list of Item's name

[
  "my item"
]

DatasetsV2FiltersItemName[]

List of Item's name

string

[ DEPRECATED ] Comma separated list of Item's name

[
  "my item"
]

item_name_prefixstring

Prefix of item's name

Example:prefix_

not_item_name_prefixstring

Prefix of item's name

Example:prefix_

item_name_containsstring

Partial item's name

Example:item

not_item_name_containsstring

Partial item's name

Example:item

DatasetsV2FiltersWorkflowStageId[]

List of Item's current workflow stage ID.

string

[ DEPRECATED ] Comma separated list of Item's current workflow stage ID.

[
  "e23ff3f3-8f77-4e78-9e81-fdb25abfb781"
]

DatasetsV2FiltersWorkflowStageId[]

List of Item's current workflow stage ID.

string

[ DEPRECATED ] Comma separated list of Item's current workflow stage ID.

[
  "e23ff3f3-8f77-4e78-9e81-fdb25abfb781"
]

DatasetsV2FiltersFileType[]

List of Type of files within the item

string

[ DEPRECATED ] Comma separated list of Type of files within the item

[
  "image"
]

DatasetsV2FiltersFileType[]

List of Type of files within the item

string

[ DEPRECATED ] Comma separated list of Type of files within the item

[
  "image"
]

DatasetsV2CommonGeneralStatus[]

List of General status of the Upload/Item. It considers processing status as well as workflow status and Item being archived/non-archived. Can be used instead of 'processing_status' and 'workflow_status' for simplicity. Item will be marked as 'complete' only if both workflow and processing is done.

string

[ DEPRECATED ] Comma separated list of General status of the Upload/Item. It considers processing status as well as workflow status and Item being archived/non-archived. Can be used instead of 'processing_status' and 'workflow_status' for simplicity. Item will be marked as 'complete' only if both workflow and processing is done.

Example:,

DatasetsV2CommonGeneralStatus[]

string

Example:,

DatasetsV2FiltersAnnotationClassId[]

List of Item's class ID

string

[ DEPRECATED ] Comma separated list of Item's class ID

[
  123
]

DatasetsV2FiltersAnnotationClassId[]

List of Item's class ID

string

[ DEPRECATED ] Comma separated list of Item's class ID

[
  123
]

WorkflowsV2ItemAssigneeId[]

List of Item's assignee ID

string

[ DEPRECATED ] Comma separated list of Item's assignee ID

[
  123
]

WorkflowsV2ItemAssigneeId[]

List of Item's assignee ID

string

[ DEPRECATED ] Comma separated list of Item's assignee ID

[
  123
]

WorkflowsV2ItemAssigneeId[]

List of Item's assignee ID

string

[ DEPRECATED ] Comma separated list of Item's assignee ID

[
  123
]

WorkflowsV2ItemAssigneeId[]

List of Item's assignee ID

string

[ DEPRECATED ] Comma separated list of Item's assignee ID

[
  123
]

include_thumbnailsboolean

Set to 'true' if you need the response to come with thumbnail URLs for each item.

include_dicom_jsonboolean

Set to 'true' if you need the response to come with a URL for the DICOM JSON of each slot

include_first_sectionsboolean

Set to 'true' if you need the response to come with URLs to first section for each item.

include_workflow_databoolean

Set to 'true' if you need the response to come with additional workflow-related data. See 'WorkflowData' schema for more details.

include_tagsboolean

Set to 'true' if you need the response to come with tags associated with Item's slots.

page[offset]integer

Defines how many items matching filters need to be skipped before returning result. Default value is 0.

Example:123

page[size]integer

Defines max number of items to return on single page. Default value is 500.

Example:500

page[to]string nullable

Page cursor on which to end the page. Page cursor consist of list of values that ends with UUID or integer

Example:2020-01-13 00:00:00,EB03745E-6A66-4BA0-802D-DE8785ABFFFE

page[from]string nullable

Page cursor from which to start the page. Page cursor consist of list of values that ends with UUID or integer

Example:2020-01-13 00:00:00,EB03745E-6A66-4BA0-802D-DE8785ABFFFE

sort[id]'asc' | 'desc'

Sort by ID. Default value is asc.

sort[name]'asc' | 'desc'

Sort by name. Default value is asc.

sort[priority]'asc' | 'desc'

Sort by priority. Default value is asc.

sort[byte_size]'asc' | 'desc'

Sort by overall size. Default value is asc.

sort[map]'asc' | 'desc'

Sort by mean average precision metric in an evaluation run. Default value is asc.

sort[updated_at]'asc' | 'desc'

Sort by recently updated. Default value is asc.

sort[accuracy]'asc' | 'desc'

Sort by accuracy metric in an evaluation run. Default value is asc.

Response

DatasetsV2.ItemManagement.ListItemsResponse

Example response

{
  "items": [
    {
      "dataset_id": 123,
      "id": "e23ff3f3-8f77-4e78-9e81-fdb25abfb781",
      "layout": {
        "slots_grid": [
          [
            [
              "1",
              "2"
            ],
            "3"
          ],
          [
            "4"
          ]
        ],
        "version": 3
      },
      "name": "some-item",
      "priority": 1,
      "slots": [
        {
          "file_name": "my_image.jpg",
          "first_section_url": "https://darwin-production-data.s3.eu-west-1.amazonaws.com/some-file.jpg?X-Amz-Signature=f0aa21e3d89ba4e7a7108eaf9873566ee5e0e3823bc5862fd3b0b9f1f44d15ac&X-Amz-Algorithm=AWS4-HMAC-SHA256",
          "id": "e23ff3f3-8f77-4e78-9e81-fdb25abfb781",
          "metadata": {
            "some_key1": "some value 1",
            "some_key2": "some value 2"
          },
          "slot_name": "0",
          "thumbnail_url": "https://darwin-production-data.s3.eu-west-1.amazonaws.com/some-file.jpg?X-Amz-Signature=f0aa21e3d89ba4e7a7108eaf9873566ee5e0e3823bc5862fd3b0b9f1f44d15ac&X-Amz-Algorithm=AWS4-HMAC-SHA256",
          "total_sections": 5,
          "upload_id": "e23ff3f3-8f77-4e78-9e81-fdb25abfb781"
        }
      ],
      "uploads": [
        {
          "file_name": "my_image.jpg",
          "processing_error": {
            "http_body": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Error><Code>AccessDenied</Code><Message>Access Denied</Message><RequestId>Some_Request_Id</RequestId><HostId>Some_Host_Id</HostId></Error>",
            "http_status_code": 403,
            "message": "An error occurred while uploading a file.",
            "stage": "upload",
            "type": "http"
          },
          "slot_name": "0",
          "upload_id": "e23ff3f3-8f77-4e78-9e81-fdb25abfb781"
        }
      ],
      "workflow_data": {
        "current_stage_instances": [
          {
            "assignee_id": 123,
            "delete_annotations_snapshot_id": "e23ff3f3-8f77-4e78-9e81-fdb25abfb781",
            "exit_snapshot_id": "e23ff3f3-8f77-4e78-9e81-fdb25abfb781",
            "parent_stage_id": "e23ff3f3-8f77-4e78-9e81-fdb25abfb781",
            "stage_id": "e23ff3f3-8f77-4e78-9e81-fdb25abfb781"
          }
        ],
        "workflow_id": "e23ff3f3-8f77-4e78-9e81-fdb25abfb781"
      }
    }
  ],
  "page": {
    "count": 500,
    "next": "2020-01-13 00:00:00,EB03745E-6A66-4BA0-802D-DE8785ABFFFE",
    "previous": "2020-01-13 00:00:00,EB03745E-6A66-4BA0-802D-DE8785ABFFFE"
  }
}

Changes

Nov 3, 20269cd7289ca12b Revision changes
- warning
  added the new DUPLICATE_REJECT_REASON enum value to the / response property for the response status
- warning
  added the new DUPLICATE_REJECT_REASON enum value to the / response property for the response status
- warning
  added the new DUPLICATE_REJECT_REASON enum value to the // response property for the response status
- warning
  added the new EXTERNAL_STORAGE_ACCESS_FAILED enum value to the / response property for the response status
- warning
  added the new EXTERNAL_STORAGE_ACCESS_FAILED enum value to the / response property for the response status
- warning
  added the new EXTERNAL_STORAGE_ACCESS_FAILED enum value to the // response property for the response status
- warning
  added the new INVALID_REJECT_REASON enum value to the / response property for the response status
- warning
  added the new INVALID_REJECT_REASON enum value to the / response property for the response status
- warning
  added the new INVALID_REJECT_REASON enum value to the // response property for the response status
- warning
  added the new INVALID_REJECT_REASONS enum value to the / response property for the response status
- warning
  added the new INVALID_REJECT_REASONS enum value to the / response property for the response status
- warning
  added the new INVALID_REJECT_REASONS enum value to the // response property for the response status
- warning
  added the new REJECT_REASON_REQUIRED enum value to the / response property for the response status
- warning
  added the new REJECT_REASON_REQUIRED enum value to the / response property for the response status
- warning
  added the new REJECT_REASON_REQUIRED enum value to the // response property for the response status
- warning
  added the new REPORT_TOO_LARGE enum value to the / response property for the response status
- warning
  added the new REPORT_TOO_LARGE enum value to the / response property for the response status
- warning
  added the new REPORT_TOO_LARGE enum value to the // response property for the response status
- warning
  added the new TOO_MANY_ACTIVE_REPORT_JOBS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_ACTIVE_REPORT_JOBS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_ACTIVE_REPORT_JOBS enum value to the // response property for the response status
- warning
  added the new TOO_MANY_PENDING_AI_REVIEW_BLUEPRINTS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_PENDING_AI_REVIEW_BLUEPRINTS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_PENDING_AI_REVIEW_BLUEPRINTS enum value to the // response property for the response status
- warning
  added the new TOO_MANY_PENDING_EXPORTS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_PENDING_EXPORTS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_PENDING_EXPORTS enum value to the // response property for the response status
- warning
  added the new TOO_MANY_REJECT_REASONS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_REJECT_REASONS enum value to the / response property for the response status
- warning
  added the new TOO_MANY_REJECT_REASONS enum value to the // response property for the response status

Operation history

List items

Request

Path parameters

Query parameters

Response 200OK

Example response

Changes

Response