Vetted.shBack to scanner

API Documentation

Integrate Vetted.sh security scanning into your workflow.

Check Skill StatusGET

Check if a skill has been scanned and get its security status.

GET /api/check?url=https://github.com/owner/repo

Example Response

{
  "verified": true,
  "status": "safe",
  "score": 95,
  "scannedAt": "2024-01-15T10:30:00.000Z",
  "issueCount": 2,
  "badgeUrl": "https://vetted.sh/badge/abc123"
}

Status Values

  • safe - Score 80-100, verified secure
  • warning - Score 50-79, some issues
  • danger - Score 0-49, significant risks
  • unknown - Not yet scanned
Install ProxyGET

Secure installation endpoint that verifies skills before executing.

curl -sL https://vetted.sh/i/[badge-hash] | sh

Behavior

  • Safe skills: Shows verification, proceeds with install
  • Warning skills: Prompts for confirmation
  • Dangerous skills: Blocks installation entirely
Badge ImageGET

Get a dynamically generated SVG badge for your README.

GET /badge/[badge-hash]

Markdown

![Vetted](https://vetted.sh/badge/[badge-hash])

Example

Safe badge
Rate Limits
  • Check endpoint: 100 requests/minute
  • Scan endpoint: 10 requests/minute
  • Badge images: Cached for 5 minutes
  • Install proxy: No limit