API Reference

curl -X POST https://www.markmyai.com/api/v1/mark \
  -H "Authorization: Bearer mk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/image.jpg"}'

curl -X POST https://www.markmyai.com/api/v1/mark \
  -H "Authorization: Bearer mk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/ai-generated.jpg",
    "ai_model": "dall-e-3",
    "creator": "Acme Corp",
    "purpose": "marketing"
  }'

{
  "status": "success",
  "mark_id": "mk_a3f9b2e4d1",
  "marked_image_url": "https://... (fresh signed delivery URL)",
  "delivery_channel": "api",
  "file_expires_at": "2026-03-11T10:30:00.000Z",
  "file_retention_days": 1,
  "verify_url": "https://markmyai.com/api/verify/mk_a3f9b2e4d1",
  "layers": {
    "watermark": {
      "status": "embedded",
      "type": "trustmark",
      "note": "Invisible watermark in pixel data, designed to survive common transformations"
    },
    "c2pa_embedded": {
      "status": "signed",
      "signer": "MarkMyAI (Beta)",
      "standard": "C2PA v2"
    },
    "audit_log": {
      "status": "recorded",
      "entry_hash": "a7f3c...",
      "fingerprint": "f0e1d2c3..."
    },
    "blockchain_anchor": {
      "status": "pending",
      "chain": "polygon",
      "note": "Anchoring in progress. Confirmation typically within 30 seconds."
    }
  },
  "image": {
    "sha256": "3a9f...",
    "fingerprint": "f0e1d2c3...",
    "format": "jpeg",
    "width": 1024,
    "height": 1024,
    "size_bytes": 245760
  },
  "timestamp": "2026-03-06T10:30:00.000Z",
  "request_id": "req_TAVQgHELicx6"
}

curl https://www.markmyai.com/api/v1/download/mk_a3f9b2e4d1 \
  -H "Authorization: Bearer mk_live_xxxxxxxxxxxx"

{
  "status": "success",
  "mark_id": "mk_a3f9b2e4d1",
  "download_url": "https://... (signed URL, valid 1h)",
  "expires_in_seconds": 3600
}

{
  "error": "Marked file no longer available",
  "code": "delivery_file_expired",
  "mark_id": "mk_a3f9b2e4d1",
  "verify_url": "https://markmyai.com/api/verify/mk_a3f9b2e4d1",
  "proof_pdf_url": "https://markmyai.com/api/proof-pdf/mk_a3f9b2e4d1",
  "proof_json_url": "https://markmyai.com/api/proof/mk_a3f9b2e4d1"
}

curl -X POST https://www.markmyai.com/api/v1/detect \
  -H "Authorization: Bearer mk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/suspected-ai-image.jpg"}'

{
  "status": "success",
  "is_marked": true,
  "query_fingerprint": "f0e1d2c3...",
  "c2pa": {
    "embedded": true,
    "data": { "...full C2PA manifest JSON..." }
  },
  "watermark": {
    "found": true,
    "crc_valid": true,
    "match_mark_id": "mk_a3f9b2e4d1",
    "match_token": "a3f9b2e4d1",
    "payload_hash": "7c3e...",
    "encoding": "BCH_SUPER",
    "decode_ms": 4200
  },
  "database_match": {
    "found": true,
    "method": "c2pa_embedded",
    "mark_id": "mk_a3f9b2e4d1",
    "verify_url": "https://markmyai.com/api/verify/mk_a3f9b2e4d1",
    "audit_record": {
      "creator": "Acme Corp",
      "ai_model": "dall-e-3",
      "marked_at": "2026-03-06T10:30:00.000Z"
    }
  },
  "fingerprint_matches": [
    {
      "mark_id": "mk_a3f9b2e4d1",
      "verify_url": "https://markmyai.com/api/verify/mk_a3f9b2e4d1",
      "creator": "Acme Corp",
      "ai_model": "dall-e-3",
      "marked_at": "2026-03-06T10:30:00.000Z",
      "similarity": "100%"
    }
  ],
  "recovery_paths": {
    "c2pa": "Embedded C2PA manifest found",
    "watermark": "Invisible watermark recovered — linked to mk_a3f9b2e4d1",
    "fingerprint": "Fingerprint match: https://markmyai.com/api/verify/mk_a3f9b2e4d1",
    "watermark_verify_url": null
  },
  "image": {
    "fingerprint": "f0e1d2c3..."
  },
  "request_id": "req_TAVQgHELicx6"
}

curl -X POST https://www.markmyai.com/api/check-watermark \
  -F "image=@photo.jpg" \
  -F "mark_id=mk_a3f9b2e4d1"

{
  "watermark_found": true,
  "crc_valid": true,
  "match_mark_id": "mk_a3f9b2e4d1",
  "match_token": "a3f9b2e4d1",
  "payload_hash": "7c3e...",
  "token_hex": "a3f9b2e4d1",
  "version": "1",
  "variant": "standard",
  "encoding": "BCH_SUPER",
  "decode_ms": 4200,
  "c2pa_found": true,
  "c2pa_claim_generator": "OpenAI DALL·E 3",
  "c2pa_signer": "OpenAI, Inc.",
  "c2pa_title": null,
  "fingerprint_match": {
    "mark_id": "mk_a3f9b2e4d1",
    "similarity": "98%",
    "creator": "Acme Corp",
    "ai_model": "dall-e-3",
    "verify_url": "https://markmyai.com/api/verify/mk_a3f9b2e4d1",
    "marked_at": "2026-03-06T10:30:00.000Z"
  },
  "query_fingerprint": "f0e1d2c3..."
}

curl https://markmyai.com/api/verify/mk_a3f9b2e4d1

{
  "mark_id": "mk_a3f9b2e4d1",
  "status": "verified",
  "proof_level": "verified_provenance",
  "proof_level_description": "Core provenance signals found and verified.",
  "proof_pdf_url": "https://markmyai.com/api/proof-pdf/mk_a3f9b2e4d1",
  "proof_json_url": "https://markmyai.com/api/proof/mk_a3f9b2e4d1",
  "provenance": {
    "creator": "Acme Corp",
    "ai_model": "dall-e-3",
    "remote_manifest": "https://markmyai.com/api/verify/mk_a3f9b2e4d1"
  },
  "image": {
    "fingerprint": "f0e1d2c3...",
    "sha256": "3a9f...",
    "watermark_embedded": true
  },
  "audit": {
    "entry_hash": "a7f3c...",
    "previous_hash": "6b2d1..."
  },
  "blockchain": {
    "status": "anchored",
    "anchor_hash": "0xa3f9...",
    "tx_hash": "0x9bc4...",
    "chain": "polygon",
    "anchored_at": "2026-03-06T10:30:25.000Z",
    "explorer_url": "https://polygonscan.com/tx/0x9bc4..."
  },
  "delivery": {
    "channel": "api",
    "retention_days": 1,
    "file_expires_at": "2026-03-11T10:30:00.000Z",
    "file_available": false,
    "storage_deleted_at": "2026-03-11T10:31:02.000Z"
  },
  "marked_at": "2026-03-06T10:30:00.000Z"
}

curl https://markmyai.com/api/proof-pdf/mk_a3f9b2e4d1 -o proof.pdf

curl https://markmyai.com/api/proof/mk_a3f9b2e4d1 -o proof.json

import requests

API_KEY = "mk_live_xxxxxxxxxxxx"
BASE_URL = "https://www.markmyai.com/api"

def mark_image(image_url: str, ai_model: str, creator: str):
    response = requests.post(
        f"{BASE_URL}/v1/mark",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "image_url": image_url,
            "ai_model": ai_model,
            "creator": creator,
        }
    )
    response.raise_for_status()
    data = response.json()
    print(f"Marked! verify_url: {data['verify_url']}")
    return data

result = mark_image(
    image_url="https://example.com/my-ai-image.jpg",
    ai_model="dall-e-3",
    creator="My Company"
)

# Detect: C2PA + Watermark + Fingerprint + DB in one call
def detect_image(image_url: str):
    response = requests.post(
        f"{BASE_URL}/v1/detect",
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={"image_url": image_url}
    )
    response.raise_for_status()
    data = response.json()
    print(f"Marked: {data['is_marked']}")
    if data["watermark"]["found"]:
        print(f"  Watermark: CRC valid={data['watermark']['crc_valid']}")
    if data["c2pa"]["embedded"]:
        print(f"  C2PA: embedded manifest found")
    if data["fingerprint_matches"]:
        print(f"  DB match: {data['fingerprint_matches'][0]['mark_id']}")
    return data

detect_image("https://example.com/suspicious-image.jpg")

# Free checker: watermark + C2PA + fingerprint (no auth)
def check_image(file_path: str):
    with open(file_path, "rb") as f:
        response = requests.post(
            f"{BASE_URL.replace('/api', '')}/api/check-watermark",
            files={"image": f}
        )
    response.raise_for_status()
    data = response.json()
    if data.get("fingerprint_match"):
        print(f"  Fingerprint match: {data['fingerprint_match']['mark_id']}")
    return data

check_image("photo.jpg")

const API_KEY = "mk_live_xxxxxxxxxxxx";

async function markImage(imageUrl, aiModel, creator) {
  const res = await fetch("https://www.markmyai.com/api/v1/mark", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ image_url: imageUrl, ai_model: aiModel, creator }),
  });

  if (!res.ok) throw new Error(`API error: ${res.status}`);
  const data = await res.json();
  console.log("Marked! verify_url:", data.verify_url);
  return data;
}

await markImage(
  "https://example.com/my-ai-image.jpg",
  "dall-e-3",
  "My Company"
);

// Detect: C2PA + Watermark + Fingerprint + DB in one call
async function detectImage(imageUrl) {
  const res = await fetch("https://www.markmyai.com/api/v1/detect", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ image_url: imageUrl }),
  });

  if (!res.ok) throw new Error(`API error: ${res.status}`);
  const data = await res.json();
  console.log("Marked:", data.is_marked);
  console.log("Watermark:", data.watermark);
  console.log("C2PA:", data.c2pa.embedded);
  console.log("DB matches:", data.fingerprint_matches.length);
  return data;
}

await detectImage("https://example.com/suspicious-image.jpg");

// Free checker: watermark + C2PA + fingerprint (no auth)
async function checkImage(file) {
  const form = new FormData();
  form.append("image", file);

  const res = await fetch("https://www.markmyai.com/api/check-watermark", {
    method: "POST",
    body: form,
  });

  if (!res.ok) throw new Error(`API error: ${res.status}`);
  const data = await res.json();
  if (data.fingerprint_match) {
    console.log("Fingerprint match:", data.fingerprint_match.mark_id);
  }
  return data;
}

# Mark an image
curl -X POST https://www.markmyai.com/api/v1/mark \
  -H "Authorization: Bearer mk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/image.jpg",
    "ai_model": "dall-e-3",
    "creator": "My Company"
  }' > response.json

# Detect: check all four layers at once
curl -X POST https://www.markmyai.com/api/v1/detect \
  -H "Authorization: Bearer mk_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/suspicious-image.jpg"}'

# Free checker: watermark + C2PA + fingerprint (no auth needed)
curl -X POST https://www.markmyai.com/api/check-watermark \
  -F "image=@photo.jpg"

# Request a fresh download URL later
curl https://www.markmyai.com/api/v1/download/mk_a3f9b2e4d1 \
  -H "Authorization: Bearer mk_live_xxxxxxxxxxxx"

# Verify a mark (no auth needed)
curl https://markmyai.com/api/verify/mk_a3f9b2e4d1

<?php
$apiKey = "mk_live_xxxxxxxxxxxx";

$response = file_get_contents("https://www.markmyai.com/api/v1/mark", false,
  stream_context_create([
    "http" => [
      "method" => "POST",
      "header" => [
        "Authorization: Bearer {$apiKey}",
        "Content-Type: application/json",
      ],
      "content" => json_encode([
        "image_url" => "https://example.com/image.jpg",
        "ai_model"  => "dall-e-3",
        "creator"   => "My Company",
      ]),
    ],
  ])
);

$data = json_decode($response, true);
echo "verify_url: " . $data["verify_url"];