Find vendors by search terms and filters

List vendors given the provided search terms and filters

Securitybearer
Request
query Parameters
page
number >= 1
Default: 1

Which page of data are you requesting

limit
number [ 1 .. 50 ]
Default: 20

How many items are you requesting

q
string

Filter data to search term

Example: q=Acme
sort
string

Which type of sort (default: NAME)

Enum: "CATEGORY" "NAME" "POLICY" "RISK" "USER" "TYPE" "STATUS" "IMPACT_LEVEL"
Example: sort=NAME
sortDir
string

Which direction to sort the data (default: ASC)

Enum: "ASC" "DESC"
Example: sortDir=ASC
category
string

Filter data to vendors of this category

Enum: "ENGINEERING" "PRODUCT" "MARKETING" "CS" "SALES" "FINANCE" "HR" "ADMINISTRATIVE" "SECURITY" "LEGAL" "NONE"
Example: category=ENGINEERING
risk
string

Filter data to vendors of this risk level

Enum: "NONE" "LOW" "MODERATE" "HIGH"
Example: risk=MODERATE
status
string

The status of vendor

Enum: "ACTIVE" "ARCHIVED" "APPROVED" "REJECTED" "FLAGGED" "ON_HOLD" "OFFBOARDED" "UNDER_REVIEW" "NONE"
Example: status=UNDER_REVIEW
contactEmail
string

The contact email of vendor

contactName
string

The name of the primary contact person

Example: contactName=John Doe
critical
boolean

Filter data to vendors depending on if it is considered critical

passwordPolicy
string

Filter data to vendors with this password policy

Enum: "USERNAME_PASSWORD" "SSO" "LDAP" "NONE"
Example: passwordPolicy=USERNAME_PASSWORD
userId
number <= 1000000000

Filter data to a person responsible for vendors

Example: userId=1
withLastQuestionnaires
boolean

Add last questionnaires to vendors

type
string

Filter data to vendors of this type

Enum: "VENDOR" "SUPPLIER" "CONTRACTOR" "PARTNER" "OTHER" "NONE"
Example: type=CONTRACTOR
impactLevel
string

Vendor overall impact level

Enum: "INSIGNIFICANT" "MINOR" "MODERATE" "MAJOR" "CRITICAL"
Example: impactLevel=INSIGNIFICANT
isArchived
boolean

Get archived or unarchived vendors

renewalDate
string

Vendor renewal date

Example: renewalDate=2024-06-14
renewalScheduleType
string

Vendor renewal schedule type

Enum: "ONE_MONTH" "TWO_MONTHS" "THREE_MONTHS" "SIX_MONTHS" "ONE_YEAR" "CUSTOM"
Example: renewalScheduleType=ONE_YEAR
renewalDateStatus
string

Vendor renewal status based on how close it is to the renewal due date

Enum: "NO_RENEWAL" "COMPLETED" "RENEWAL_DUE_SOON" "RENEWAL_DUE"
Example: renewalDateStatus=COMPLETED
sharedAccountId
string

Shared account id

Responses
200
400

Malformed data and/or validation errors

401

Invalid Authorization

403

You are not allowed to perform this action

500

Internal server error

default

Response Code: 412

You must accept the Drata terms and conditions to use the API

get/public/vendors
Request samples
Response samples
application/json
{
  • "data": [ ],
  • "page": 1,
  • "limit": 10,
  • "total": 100
}