Carpe Intel

API Documentation

REST endpoints for creating, tracking, managing, and exporting AI-powered OSINT investigations.

POST/api/investigate

Create new investigation

Request Body

{
  "subject": {
    "name": "John Doe",
    "dob": "1985-06-14",
    "address": "123 Main St",
    "city": "Austin",
    "state": "TX",
    "emails": ["john@example.com"],
    "phones": ["+1-555-123-4567"],
    "claimType": "workers_comp",
    "condition": "back injury",
    "doi": "2026-01-10"
  },
  "tier": "thinking"
}

Response

{
  "id": "inv_9f6d7a12",
  "status": "pending"
}
GET/api/status/:id

Get investigation status/progress

Response

{
  "id": "inv_9f6d7a12",
  "subject": {
    "name": "John Doe",
    "dob": "1985-06-14",
    "city": "Austin",
    "state": "TX"
  },
  "tier": "thinking",
  "status": "processing",
  "progress": {
    "total": 8,
    "completed": 5,
    "currentSource": "LinkedIn"
  },
  "socialProfiles": [],
  "webResults": [],
  "imageResults": [],
  "newsResults": [],
  "claimsFlags": [],
  "createdAt": "2026-03-02T18:17:02.521Z",
  "updatedAt": "2026-03-02T18:18:10.013Z"
}
GET/api/investigations

List all investigations

Response

{
  "investigations": [
    {
      "id": "inv_9f6d7a12",
      "subject": { "name": "John Doe" },
      "tier": "thinking",
      "status": "complete",
      "progress": { "total": 8, "completed": 8, "currentSource": "done" },
      "socialProfiles": [],
      "webResults": [],
      "imageResults": [],
      "newsResults": [],
      "createdAt": "2026-03-02T18:17:02.521Z",
      "completedAt": "2026-03-02T18:19:55.112Z"
    }
  ]
}
DELETE/api/investigations/:id

Delete investigation

Response

{
  "success": true,
  "id": "inv_9f6d7a12"
}
POST/api/investigations/:id/rerun

Re-run investigation

Response

{
  "id": "inv_9f6d7a12",
  "status": "pending"
}
GET/api/report/:id?format=html|pdf

Download report

Response

{
  "downloadUrl": "/api/report/inv_9f6d7a12?format=pdf",
  "format": "pdf"
}
POST/api/magic-parse

AI extraction from text

Request Body

{
  "text": "Claimant is John Doe, DOB 06/14/1985, living at 123 Main St, Austin TX. Possible Facebook handle @johndoe."
}

Response

{
  "subject": {
    "name": "John Doe",
    "dob": "1985-06-14",
    "address": "123 Main St",
    "city": "Austin",
    "state": "TX",
    "handle": "@johndoe"
  }
}