Skip to main content
GET
/
v1
/
deepfake-detection
/
{id}
Retrieve Analysis
curl --request GET \
  --url https://api.deepidv.com/v1/deepfake-detection/{id}
{
  "id": "da_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "file_name": "bank_statement_jan2025.pdf",
  "file_type": "document",
  "external_id": "doc-review-789",
  "created_at": "2025-01-15T10:30:00.000Z",
  "completed_at": "2025-01-15T10:30:18.000Z",
  "result": {
    "is_ai_generated": true,
    "confidence_score": 87.3,
    "risk_level": "critical",
    "detection_details": [
      {
        "signal_type": "FONT_INCONSISTENCY",
        "confidence": 91.2,
        "description": "Multiple font rendering engines detected within the same document, indicating post-creation editing"
      },
      {
        "signal_type": "METADATA_INCONSISTENCY",
        "confidence": 84.5,
        "description": "Document creation metadata conflicts with content dates — file created 2025-01-14 but contains transactions dated 2025-01-31"
      },
      {
        "signal_type": "PIXEL_MANIPULATION",
        "confidence": 78.9,
        "description": "Image layer analysis reveals pixel-level modifications in transaction amount regions"
      }
    ],
    "file_metadata": {
      "creator": "Google Chrome",
      "creation_date": "2025-01-14T22:15:00.000Z",
      "modification_date": "2025-01-14T23:42:00.000Z",
      "page_count": 3,
      "encrypted": false
    }
  }
}

GET /v1/deepfake-detection/{id}
Retrieves the full details and results of a deepfake detection analysis by its ID.

​
Request

​
Headers

HeaderRequiredDescription
x-api-keyYesYour API key

​
Path parameters

ParameterTypeRequiredDescription
idstringYesThe analysis ID (returned when the analysis was created)

​
Example request

curl -X GET https://api.deepidv.com/v1/deepfake-detection/da_a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
  -H "x-api-key: YOUR_API_KEY"

​
Response

​
200 — Success

FieldTypeDescription
idstringUnique analysis identifier
statusstringprocessing, completed, or failed
file_namestringOriginal filename
file_typestringDetected file type category
external_idstringYour external ID (if provided)
created_atstringISO 8601 creation timestamp
completed_atstringISO 8601 completion timestamp (null if processing)
resultobjectAnalysis results (only present when status is completed)

​
result object

FieldTypeDescription
is_ai_generatedbooleanWhether the content is determined to be AI-generated
confidence_scorenumberConfidence score (0—100) that the content is AI-generated or manipulated
risk_levelstringlow, medium, high, or critical
detection_detailsarrayArray of specific detection findings
file_metadataobjectFormat-specific metadata extracted from the file

​
detection_details array items

FieldTypeDescription
signal_typestringType of detection signal (e.g., GAN_ARTIFACTS, METADATA_INCONSISTENCY, PIXEL_MANIPULATION)
confidencenumberConfidence for this specific signal (0—100)
descriptionstringHuman-readable description of the finding

​
file_metadata object

Varies by file type.
FieldTypeDescription
creatorstringSoftware that created the file
creation_datestringFile creation date from metadata
modification_datestringLast modification date
page_countnumberNumber of pages (documents only)
dimensionsobjectWidth and height (images only)
duration_secondsnumberDuration (audio/video only)
codecstringCodec information (audio/video only)

​
Error responses

StatusDescription
400 Bad RequestInvalid analysis ID format
401 UnauthorizedMissing or invalid API key
403 ForbiddenAnalysis belongs to a different organization
404 Not FoundAnalysis ID does not exist
429 Too Many RequestsRate limit exceeded
{
  "id": "da_a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "file_name": "bank_statement_jan2025.pdf",
  "file_type": "document",
  "external_id": "doc-review-789",
  "created_at": "2025-01-15T10:30:00.000Z",
  "completed_at": "2025-01-15T10:30:18.000Z",
  "result": {
    "is_ai_generated": true,
    "confidence_score": 87.3,
    "risk_level": "critical",
    "detection_details": [
      {
        "signal_type": "FONT_INCONSISTENCY",
        "confidence": 91.2,
        "description": "Multiple font rendering engines detected within the same document, indicating post-creation editing"
      },
      {
        "signal_type": "METADATA_INCONSISTENCY",
        "confidence": 84.5,
        "description": "Document creation metadata conflicts with content dates — file created 2025-01-14 but contains transactions dated 2025-01-31"
      },
      {
        "signal_type": "PIXEL_MANIPULATION",
        "confidence": 78.9,
        "description": "Image layer analysis reveals pixel-level modifications in transaction amount regions"
      }
    ],
    "file_metadata": {
      "creator": "Google Chrome",
      "creation_date": "2025-01-14T22:15:00.000Z",
      "modification_date": "2025-01-14T23:42:00.000Z",
      "page_count": 3,
      "encrypted": false
    }
  }
}