Vendors API

Manage vendors, assess risk, and track vendor contracts.

Endpoints

Method	Path	Description
`GET`	`/vendors`	List vendors
`POST`	`/vendors`	Create vendor
`GET`	`/vendors/:id`	Get vendor details
`PUT`	`/vendors/:id`	Update vendor
`DELETE`	`/vendors/:id`	Remove vendor
`POST`	`/vendors/:id/risk-assessment`	AI risk assessment
`POST`	`/vendors/:id/generate-nda`	Auto-generate NDA

List Vendors

GET /api/v1/vendors?status=active&risk_level=high

{
  "vendors": [
    {
      "id": "vendor-uuid",
      "name": "Cloud Services Inc.",
      "contact_email": "billing@cloudservices.com",
      "status": "active",
      "risk_level": "low",
      "risk_score": 25,
      "category": "Technology",
      "created_at": "2026-01-15T10:00:00Z"
    }
  ],
  "total": 8
}

Create Vendor

POST /api/v1/vendors

{
  "name": "Cloud Services Inc.",
  "contact_name": "John Doe",
  "contact_email": "john@cloudservices.com",
  "contact_phone": "+1-555-0100",
  "category": "Technology",
  "website": "https://cloudservices.com",
  "notes": "Primary cloud infrastructure provider"
}

AI Risk Assessment

POST /api/v1/vendors/:id/risk-assessment

{
  "risk_score": 35,
  "risk_level": "low",
  "assessment": {
    "financial_stability": "strong",
    "data_handling": "compliant",
    "contract_coverage": "adequate",
    "recommendations": [
      "Consider adding a data breach notification clause",
      "Annual compliance review recommended"
    ]
  }
}

Generate NDA

Auto-generate an NDA for a vendor relationship.

POST /api/v1/vendors/:id/generate-nda

{
  "party_name": "My Company LLC",
  "duration_years": 2
}

Returns a new contract linked to this vendor with AI-generated NDA content.

Compliance Analytics