Get a list's job history

get/lists/{listId}/jobs

Returns a collection of the list's job history.

Request Samples

1

Response Samples

1{
2  "count": 1,
3  "start": 0,
4  "limit": 10,
5  "items": [
6    {
7      "id": "eb496682-68fa-44d1-a486-9371d78ab624",
8      "version": 1,
9      "type": "import",
10      "state": "completed",
11      "createdAt": "2025-05-20T09:10:26.770615Z",
12      "completedAt": "2025-05-20T09:10:26.795747Z",
13      "createdBy": "appUser1",
14      "lastUpdated": "2025-05-20T09:10:26.795747Z",
15      "listId": "2cab2e23-e95a-4a16-b1f4-32d2d7f5e6cf"
16    },
17    {
18      "id": "069b7b0f-39aa-4ac2-b62e-598cc9fa6293",
19      "version": 1,
20      "type": "purge",
21      "state": "completed",
22      "createdAt": "2025-05-20T09:19:51.043905Z",
23      "completedAt": "2025-05-20T09:19:51.058814Z",
24      "createdBy": "appUser1",
25      "lastUpdated": "2025-05-20T09:19:51.058814Z",
26      "listId": "2cab2e23-e95a-4a16-b1f4-32d2d7f5e6cf"
27    }
28  ]
29}

Path Parameters

NameTypeRequiredDescription
listId
string
true

The unique identifier for a list.

Query Parameters

NameTypeRequiredDescription
filter
string<filter-criteria>
false

The filter criteria for returned items. See Filtering in REST APIs.

limit
integer
false

The maximum number of items to return. The default value is '20'.

sortBy
string<sort-criteria>
false

A sort of the returned items. See Sorting in REST APIs.

start
integer
false

A zero-based offset of the first item to return. The default value is '0'.

Responses

StatusMeaningDescription
200OK

The request succeeded.

HeadersSchema
400Bad Request

The request was invalid.

Schema
403Forbidden

The user did not have the necessary permissions.

Schema
404Not Found

No item exists at the requested path.

Schema
500Internal Server Error

The request could not be fulfilled because of an unexpected server error.

Schema