API Endpoints

Complete reference of available API endpoints.

Base URL

https://api.blocksecops.com/api/v1

---

Contracts

Manage smart contract source code.

Method	Endpoint	Description
POST	/contracts/upload	Upload contract file(s)
GET	/contracts	List contracts
GET	/contracts/{id}	Get contract details
DELETE	/contracts/{id}	Delete contract
GET	/contracts/{id}/analytics	Get contract analytics

---

Scans

Execute and monitor security scans.

Method	Endpoint	Description
POST	/scans	Start new scan
GET	/scans	List scans
GET	/scans/{id}	Get scan status
GET	/scans/{id}/results	Get scan results
POST	/scans/{id}/cancel	Cancel running scan
GET	/scans/compare	Compare two scans

---

Vulnerabilities

View and manage detected vulnerabilities.

Method	Endpoint	Description
GET	/vulnerabilities	List all vulnerabilities
GET	/vulnerabilities/{id}	Get vulnerability details
PATCH	/vulnerabilities/{id}/status	Update vulnerability status
GET	/vulnerabilities/categories	List vulnerability categories
GET	/vulnerabilities/scanners	List scanners
GET	/vulnerabilities/stats/by-scanner	Stats by scanner
GET	/vulnerabilities/stats/by-category	Stats by category
GET	/scans/{id}/vulnerabilities	List vulnerabilities for scan

---

Projects

Organize contracts into projects.

Method	Endpoint	Description
GET	/projects	List projects
POST	/projects	Create project
GET	/projects/{id}	Get project details
PATCH	/projects/{id}	Update project
DELETE	/projects/{id}	Delete project
GET	/projects/{id}/contracts	List project contracts

---

Organizations

Manage organization settings and members.

Method	Endpoint	Description
GET	/organizations	List organizations
POST	/organizations	Create organization
GET	/organizations/{id}	Get organization
PATCH	/organizations/{id}	Update organization
GET	/organizations/{id}/members	List members
POST	/organizations/{id}/members	Add member
DELETE	/organizations/{id}/members/{user_id}	Remove member

---

Teams

Manage teams within organizations.

Method	Endpoint	Description
GET	/teams	List teams
POST	/teams	Create team
GET	/teams/{id}	Get team
PATCH	/teams/{id}	Update team
DELETE	/teams/{id}	Delete team
GET	/teams/{id}/members	List team members

---

API Keys

Manage API keys programmatically.

Method	Endpoint	Description
GET	/api-keys	List API keys
POST	/api-keys	Create API key
GET	/api-keys/{id}	Get API key details
PATCH	/api-keys/{id}	Update API key
DELETE	/api-keys/{id}	Revoke API key

---

Webhooks

Configure webhook notifications.

Method	Endpoint	Description
GET	/webhooks	List webhooks
POST	/webhooks	Create webhook
GET	/webhooks/{id}	Get webhook
PATCH	/webhooks/{id}	Update webhook
DELETE	/webhooks/{id}	Delete webhook
POST	/webhooks/{id}/test	Test webhook

---

Audit Logs

View activity logs.

Method	Endpoint	Description
GET	/audit-logs	List audit logs
GET	/audit-logs/{id}	Get audit log entry

---

Health

Service health endpoints (no authentication required).

Method	Endpoint	Description
GET	/health/live	Liveness check
GET	/health/ready	Readiness check
GET	/health/startup	Startup check