isitcredible.com

Base URL

Authentication

Generate an API key from your account page. Include it as a Bearer token in every request:

Authorization: Bearer iic_your_api_key_here

Keys require a verified email address. They are stored as one-way hashes — if you lose a key, revoke it and generate a new one.

Report Options

Each job is configured with boolean flags. At least one of do_report or do_code must be set.

Length-based pricing. The report-side prices above cover a main text (plus supplements) of up to 50 pages. Above that, the report-side total scales by 1% per additional page — so a 100-page submission costs 1.5× the flat price. The code charge is independent of main-text length. If your balance is insufficient, the 402 error states the exact price for your submission.

Legacy modes. The former mode parameter is still accepted: standard maps to do_report, extended to do_report + do_copyedit, and inspect_code=true to do_code.

Prices may change. Registered account holders will be notified by email before any change takes effect.

Endpoints

{"balance_cents": 1500, "balance_usd": 15.0}

[
  {
    "uuid": "a1b2c3d4",
    "status": "completed",
    "mode": "standard",
    "title": "On the Origins of...",
    "authors": "Smith, J. et al.",
    "audit_date": "2026-03-06T14:22:00"
  }
]

{
  "uuid": "a1b2c3d4",
  "status": "completed",
  "mode": "standard",
  "title": "On the Origins of...",
  "authors": "Smith, J. et al.",
  "discipline": "Economics",
  "audit_date": "2026-03-06T14:22:00",
  "report_url": "https://isitcredible.com/api/v1/jobs/a1b2c3d4/report"
}

{
  "job_id": "a1b2c3d4",
  "status": "processing",
  "mode": "standard",
  "message": "Job submitted. Poll GET /api/v1/jobs/a1b2c3d4 for status."
}

Error Reference

Examples

curl

# Check balance
curl https://isitcredible.com/api/v1/credits \
     -H "Authorization: Bearer iic_your_key"

# Submit a PDF for the standard report
curl -X POST https://isitcredible.com/api/v1/jobs \
     -H "Authorization: Bearer iic_your_key" \
     -F "main_file=@paper.pdf" \
     -F "user_note=This is a draft journal article in economics."

# Report + math audit, with a supplementary appendix
curl -X POST https://isitcredible.com/api/v1/jobs \
     -H "Authorization: Bearer iic_your_key" \
     -F "main_file=@paper.pdf" \
     -F "supp_files=@appendix.pdf" \
     -F "do_math=true"

# Report + code review of a replication package
curl -X POST https://isitcredible.com/api/v1/jobs \
     -H "Authorization: Bearer iic_your_key" \
     -F "main_file=@paper.pdf" \
     -F "do_code=true" \
     -F "code_files=@analysis.do" \
     -F "code_files=@build_data.R" \
     -F "code_files=@README.md"

# Poll for status
curl https://isitcredible.com/api/v1/jobs/a1b2c3d4 \
     -H "Authorization: Bearer iic_your_key"

# Download report (once status is 'completed')
curl -OJ https://isitcredible.com/api/v1/jobs/a1b2c3d4/report?format=txt \
     -H "Authorization: Bearer iic_your_key"

Python

import requests, time

API_KEY = "iic_your_key"
BASE    = "https://isitcredible.com/api/v1"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# Submit
with open("paper.pdf", "rb") as f:
    r = requests.post(
        f"{BASE}/jobs",
        headers=HEADERS,
        files={"main_file": f},
        data={"do_math": "true", "user_note": "Draft economics paper."}
    )
r.raise_for_status()
job_id = r.json()["job_id"]
print(f"Submitted: {job_id}")

# Poll until complete (jobs typically take 20–60 minutes)
# Save job_id before polling — if your process times out the job keeps running
# and you can resume by polling job_id again later.
while True:
    job = requests.get(f"{BASE}/jobs/{job_id}", headers=HEADERS).json()
    print(f"Status: {job['status']}")
    if job["status"] in ("completed", "published"):
        break
    if job["status"] in ("failed", "suspended"):
        raise RuntimeError(f"Job {job['status']}")
    time.sleep(60)

# Download PDF
report = requests.get(f"{BASE}/jobs/{job_id}/report", headers=HEADERS)
report.raise_for_status()
with open("report.pdf", "wb") as f:
    f.write(report.content)
print("Report saved to report.pdf")

# Download TXT version
report_txt = requests.get(f"{BASE}/jobs/{job_id}/report", headers=HEADERS, params={"format": "txt"})
report_txt.raise_for_status()
with open("report.txt", "w") as f:
    f.write(report_txt.text)
print("Text report saved to report.txt")

pip install isitcredible

from isitcredible import Client, JobTimeoutError

client = Client("iic_your_api_key")

# One-liner: submit, poll, and download
report = client.analyze("paper.pdf")
report.save("review.pdf")

# Handle timeouts — the job keeps running on the server
try:
    report = client.analyze("paper.pdf", timeout=3600)
except JobTimeoutError as e:
    print(f"Still running. Resume with: client.wait('{e.job_id}')")

# Webhook management
client.create_webhook("https://yourapp.com/webhook")
hooks = client.list_webhooks()