Get the backup status of devices (internal)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}

POST /extraction/device/extraction-status

Access token

Desktop plumbing: for each listed device, returns when it last finished a backup with the caller's extraction code on that computer, and whether the code's collection settings have changed since (hasNewEcCodeConfig). A device with no finished backup gets lastBackupAt: null.

application/json

Body Required

devices array[object] Required
Hide devices attributes Show devices attributes object
- deviceId string Required
- deviceType string Required
- systemId string Required

Responses

200 application/json
Hide response attributes Show response attributes object
- data object Required
  
  Hide data attribute Show data attribute object
  
  devices array[object] Required
  
  Hide devices attributes Show devices attributes object
  
  lastBackupAt string(date-time) Required
  
  hasNewEcCodeConfig boolean Required
  
  deviceId string Required
  
  deviceType string Required
- statusCode number Required
- timestamp string(date-time) Required

POST /extraction/device/extraction-status

curl \
 --request POST 'http://api.example.com/extraction/device/extraction-status' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "devices": [
    {
      "deviceId": "string",
      "deviceType": "string",
      "systemId": "string"
    }
  ]
}'

Request examples

{
  "devices": [
    {
      "deviceId": "string",
      "deviceType": "string",
      "systemId": "string"
    }
  ]
}

Response examples (200)

{
  "data": {
    "devices": [
      {
        "lastBackupAt": "2026-05-04T09:42:00Z",
        "hasNewEcCodeConfig": true,
        "deviceId": "string",
        "deviceType": "string"
      }
    ]
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}