Archivematica API

Endpoints require authentication with a username and API key. This can be submitted as GET parameters (eg ?username=demo&api_key=e6282adabed84e39ffe451f8bf6ff1a67c1fc9f2) or as a header (eg Authorization: ApiKey demo:e6282adabed84e39ffe451f8bf6ff1a67c1fc9f2)

Endpoints return JSON. If there's an error, they will return a 4xx or 5xx HTTP error code and a JSON body {'error': True, 'message': 'message describing error'}

Transfer

Status

• URL: /transfer/status/<unit UUID>/
• Verbs: GET
• Returns the status of the Transfer
• Fields:
  • status: One of FAILED, REJECTED, USER_INPUT, COMPLETE or PROCESSING
  • name: Name of the transfer, e.g. "imgs"
  • sip_uuid: If status is COMPLETE, this field will exist with either the UUID of the SIP or 'BACKLOG'
  • microservice: Name of the current microservice
  • directory: Name of the directory, e.g. "imgs-52dd0c01-e803-423a-be5f-b592b5d5d61c"
  • path: Full path to the transfer, e.g. "/var/archivematica/sharedDirectory/watchedDirectories/SIPCreation/completedTransfers/imgs-52dd0c01-e803-423a-be5f-b592b5d5d61c/"
  • message: "Fetched status for <transfer UUID> successfully."
  • type: "transfer"
  • uuid: UUID of the transfer, e.g. "52dd0c01-e803-423a-be5f-b592b5d5d61c"

Ingest

• URL: /ingest/status/<unit UUID>/
• Verbs: GET
• Returns the status of the SIP
• Fields:
  • status: One of FAILED, REJECTED, USER_INPUT, COMPLETE or PROCESSING
  • name: Name of the SIP, e.g. "imgs"
  • microservice: Name of the current microservice
  • directory: Name of the directory, e.g. "imgs-52dd0c01-e803-423a-be5f-b592b5d5d61c"
  • path: Full path to the transfer, e.g. "/var/archivematica/sharedDirectory/currentlyProcessing/imgs-52dd0c01-e803-423a-be5f-b592b5d5d61c/"
  • message: "Fetched status for <SIP UUID> successfully."
  • type: "SIP"
  • uuid: UUID of the SIP, e.g. "52dd0c01-e803-423a-be5f-b592b5d5d61c"