Items Endpoint

The /member-api/v1/items endpoint currently supports only GET requests, meaning it is a read-only endpoint for now.

GET /member-api/v1/items 

This endpoint returns a list of items in the APTrust work queue, including items where the work has been completed. Use this endpoint to check the status of any of the following: 
  • bag ingest requests
  • restoration requests
  • deletion requests
  • requests to send items to DPN

Filter Parameters

The endpoint accepts the following query string parameters to filter results. If you are periodically checking on the status of items in the work queue, the updated_since param is your best friend!

JSON Response Format


{
    "count": 5750,
    "next": "http://test.aptrust.org/member-api/v1/items/?page=11&per_page=5",
    "previous": "http://test.aptrust.org/member-api/v1/items/?page=9&per_page=5",
    "results": [
        [
            {
                "id": 130591,
                "created_at": "2014-11-24T18:56:11.348Z",
                "updated_at": "2014-11-24T19:17:03.715Z",
                "name": "ncsu.1840.16-102.tar",
                "etag": "c8b80aadba6adabff06d35e029175daf",
                "bucket": "aptrust.receiving.test.ncsu.edu",
                "user": "system@aptrust.org",
                "institution": "ncsu.edu",
                "note": "No problems",
                "action": "Ingest",
                "stage": "Record",
                "status": "Success",
                "outcome": "Success",
                "bag_date": "2014-10-27T14:46:34.000Z",
                "date": "2014-11-24T19:14:55.751Z",
                "retry": false,
                "reviewed": false,
                "object_identifier": "ncsu.edu/ncsu.1840.16-102",
                "generic_file_identifier": null
            },
            {
                "id": 130592,
                "created_at": "2014-11-24T18:56:11.550Z",
                "updated_at": "2014-11-24T19:17:11.902Z",
                "name": "ncsu.1840.16-1020.tar",
                "etag": "f5cdd9cbaf4808c7a618905084134474",
                "bucket": "aptrust.receiving.test.ncsu.edu",
                "user": "system@aptrust.org",
                "institution": "ncsu.edu",
                "note": "No problems",
                "action": "Ingest",
                "stage": "Record",
                "status": "Success",
                "outcome": "Success",
                "bag_date": "2014-10-27T14:46:34.000Z",
                "date": "2014-11-24T19:15:04.479Z",
                "retry": false,
                "reviewed": false,
                "object_identifier": "ncsu.edu/ncsu.1840.16-1020",
                "generic_file_identifier": null
            },
            {
                "id": 130595,
                "created_at": "2014-11-24T18:56:12.252Z",
                "updated_at": "2014-11-24T19:17:31.858Z",
                "name": "ncsu.1840.16-1023.tar",
                "etag": "fa28cd2c9bef9515210c89fdcb49e80b",
                "bucket": "aptrust.receiving.test.ncsu.edu",
                "user": "system@aptrust.org",
                "institution": "ncsu.edu",
                "note": "No problems",
                "action": "Ingest",
                "stage": "Record",
                "status": "Success",
                "outcome": "Success",
                "bag_date": "2014-10-27T14:46:35.000Z",
                "date": "2014-11-24T19:15:23.855Z",
                "retry": false,
                "reviewed": false,
                "object_identifier": "ncsu.edu/ncsu.1840.16-1023",
                "generic_file_identifier": null
            },
            {
                "id": 130599,
                "created_at": "2014-11-24T18:56:13.049Z",
                "updated_at": "2014-11-24T19:17:44.847Z",
                "name": "ncsu.1840.16-1027.tar",
                "etag": "ab4681a9e3819cf91e21f3243b524ea6",
                "bucket": "aptrust.receiving.test.ncsu.edu",
                "user": "system@aptrust.org",
                "institution": "ncsu.edu",
                "note": "No problems",
                "action": "Ingest",
                "stage": "Record",
                "status": "Success",
                "outcome": "Success",
                "bag_date": "2014-10-27T14:46:36.000Z",
                "date": "2014-11-24T19:15:37.512Z",
                "retry": false,
                "reviewed": false,
                "object_identifier": "ncsu.edu/ncsu.1840.16-1027",
                "generic_file_identifier": null
            },
            {
                "id": 130602,
                "created_at": "2014-11-24T18:56:13.656Z",
                "updated_at": "2014-11-24T19:18:16.023Z",
                "name": "ncsu.1840.16-103.tar",
                "etag": "654f0928c54ff5487635638a2970af2f",
                "bucket": "aptrust.receiving.test.ncsu.edu",
                "user": "system@aptrust.org",
                "institution": "ncsu.edu",
                "note": "No problems",
                "action": "Ingest",
                "stage": "Record",
                "status": "Success",
                "outcome": "Success",
                "bag_date": "2014-10-27T14:46:36.000Z",
                "date": "2014-11-24T19:16:07.414Z",
                "retry": false,
                "reviewed": false,
                "object_identifier": "ncsu.edu/ncsu.1840.16-103",
                "generic_file_identifier": null
            }
        ]
    ]
}



Updated on Mar 31, 2016 by Andrew Diamond (Version 7)