List vendors given the provided search terms and filters
🔒 Requires Vendors: List Vendors permission.
💎 Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "name": "Acme",
- "category": "ENGINEERING",
- "risk": "MODERATE",
- "type": "CONTRACTOR",
- "critical": false,
- "location": "USA",
- "trustCenterProvider": "DRATA",
- "servicesProvided": "Perform security scans once a month",
- "dataStored": "Resulting reports of security scans",
- "hasPii": true,
- "passwordPolicy": "USERNAME_PASSWORD",
- "passwordRequiresMinLength": true,
- "passwordMinLength": 8,
- "passwordRequiresNumber": true,
- "passwordRequiresSymbol": true,
- "passwordMfaEnabled": true,
- "contactAtVendor": "John Doe",
- "notes": "Meeting once a month to adjust contract",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": null,
- "name": null,
- "type": null,
- "fileUrl": null,
- "renewalDate": null,
- "createdAt": null,
- "updatedAt": null
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "vendorRelationshipContact": {
- "id": 1,
- "firstName": "Adam",
- "lastName": "Attack",
- "createdAt": "2025-01-08T21:18:10.846Z",
- "updatedAt": "2025-01-10T23:46:09.000Z"
}, - "documents": [
- {
- "id": 1,
- "name": "AWS SOC 2 2018",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "lastQuestionnaire": {
- "vendorId": 0,
- "sendAt": "string",
- "sentEmail": "string",
- "file": "string",
- "respondedAt": "string",
- "responseId": 0,
- "isManualUpload": true,
- "completedBy": "string"
}, - "isSubProcessor": false,
- "isSubProcessorActive": false,
- "archivedAt": "2025-07-01T16:45:55.246Z",
- "status": "ACTIVE",
- "renewalDate": "2020-07-06",
- "renewalScheduleType": "ONE_YEAR",
- "renewalDateStatus": "COMPLETED",
- "confirmedAt": "2025-07-01T16:45:55.246Z",
- "reviews": [
- {
- "id": 1,
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "reviewer": "John Doe",
- "reviewDate": "2025-07-01T16:45:55.246Z",
- "reportIssueDate": "2025-07-01T16:45:55.246Z",
- "socReport": "SOC_1",
- "socReportType1": true,
- "socReportType2": true,
- "socType1StartDate": "2025-07-01T16:45:55.246Z",
- "socType1EndDate": "2025-07-01T16:45:55.246Z",
- "socType2StartDate": "2025-07-01T16:45:55.246Z",
- "socType2EndDate": "2025-07-01T16:45:55.246Z",
- "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "User must proceed to...",
- "hasMaterialImpact": true,
- "cpaFirm": "CPA firm name",
- "cpaProcedurePerformed": "The following procedures were performed...",
- "subserviceOrganization": "Subservice Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "The following procedures were performed...",
- "trustServiceCategories": [
- {
- "id": 1,
- "category": "AVAILABILITY"
}
], - "userControls": [
- {
- "id": 1,
- "name": "End User Control 1",
- "inPlace": true
}
], - "services": [
- {
- "id": 1,
- "name": "Service 1"
}
], - "locations": [
- {
- "id": 1,
- "city": "San Diego",
- "stateCountry": "CA"
}
], - "findings": [
- {
- "id": 1,
- "description": "Finding 1"
}
]
}
], - "sharedAccountId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "isDrataUser": false,
- "events": 4,
- "impactLevel": "INSIGNIFICANT",
- "securityReview": {
- "id": 1,
- "requestedAt": "2019-08-24T14:15:22Z",
- "reviewDeadlineAt": "2019-08-24T14:15:22Z",
- "decision": "APPROVED",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": null,
- "clientType": null,
- "state": null,
- "connected": null,
- "connectedAt": null,
- "failedAt": null,
- "companyId": null,
- "assignmentId": null,
- "user": null,
- "accountId": null,
- "clientId": null,
- "clientAlias": null,
- "manuallyUpdatedAt": null,
- "aliasUpdatedAt": null,
- "deletedAt": null,
- "requestorId": null,
- "product": { },
- "writeAccessEnabled": null,
- "sourcePreference": null,
- "securityLabel": null,
- "jqlQuery": null,
- "authorized": null,
- "workspaces": [ ],
- "providerTypes": [ ],
- "code": null,
- "groupIdList": [ ]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- null
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "vendor": {
- "id": 1,
- "name": "Acme",
- "category": "ENGINEERING",
- "risk": "MODERATE",
- "type": "CONTRACTOR",
- "critical": false,
- "location": "USA",
- "trustCenterProvider": "DRATA",
- "servicesProvided": "Perform security scans once a month",
- "dataStored": "Resulting reports of security scans",
- "hasPii": true,
- "passwordPolicy": "USERNAME_PASSWORD",
- "passwordRequiresMinLength": true,
- "passwordMinLength": 8,
- "passwordRequiresNumber": true,
- "passwordRequiresSymbol": true,
- "passwordMfaEnabled": true,
- "contactAtVendor": "John Doe",
- "notes": "Meeting once a month to adjust contract",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": null,
- "userId": null,
- "status": null,
- "caseId": null,
- "caseInvitationId": null,
- "url": null,
- "manualCheckDate": null,
- "manuallyCheckUrl": null,
- "type": null,
- "source": null,
- "reportData": null,
- "user": null,
- "outOfScopeReason": null,
- "outOfScopeAt": null,
- "invitationEmail": null,
- "linkedAt": null,
- "createdAt": null,
- "updatedAt": null
}
], - "identities": [
- {
- "id": null,
- "identityId": null,
- "username": null,
- "connectedAt": null,
- "disconnectedAt": null,
- "hasMfa": null,
- "user": null,
- "connection": null,
- "hasIdp": null,
- "secondaryEmail": null,
- "firstName": null,
- "lastName": null,
- "startedAt": null,
- "separatedAt": null,
- "isContractor": null,
- "jobTitle": null,
- "managerId": null,
- "managerName": null
}
], - "documents": [
- {
- "data": [ ],
- "page": null,
- "limit": null,
- "total": null
}
]
}, - "documents": [
- {
- "id": 1,
- "name": "AWS SOC 2 2018",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "lastQuestionnaire": {
- "vendorId": 0,
- "sendAt": "string",
- "sentEmail": "string",
- "file": "string",
- "respondedAt": "string",
- "responseId": 0,
- "isManualUpload": true,
- "completedBy": "string"
}, - "isSubProcessor": false,
- "isSubProcessorActive": false,
- "archivedAt": "2025-07-01T16:45:55.246Z",
- "status": "ACTIVE",
- "renewalDate": "2020-07-06",
- "renewalScheduleType": "ONE_YEAR",
- "renewalDateStatus": "COMPLETED",
- "confirmedAt": "2025-07-01T16:45:55.246Z",
- "reviews": [
- {
- "id": 1,
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "reviewer": "John Doe",
- "reviewDate": "2025-07-01T16:45:55.246Z",
- "reportIssueDate": "2025-07-01T16:45:55.246Z",
- "socReport": "SOC_1",
- "socReportType1": true,
- "socReportType2": true,
- "socType1StartDate": "2025-07-01T16:45:55.246Z",
- "socType1EndDate": "2025-07-01T16:45:55.246Z",
- "socType2StartDate": "2025-07-01T16:45:55.246Z",
- "socType2EndDate": "2025-07-01T16:45:55.246Z",
- "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "User must proceed to...",
- "hasMaterialImpact": true,
- "cpaFirm": "CPA firm name",
- "cpaProcedurePerformed": "The following procedures were performed...",
- "subserviceOrganization": "Subservice Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "The following procedures were performed...",
- "trustServiceCategories": [
- null
], - "userControls": [
- null
], - "services": [
- null
], - "locations": [
- null
], - "findings": [
- null
]
}
], - "sharedAccountId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "isDrataUser": false,
- "events": 4,
- "integrations": [
- {
- "id": 1,
- "name": "Acme"
}
], - "cost": "1088",
- "operationalImpact": "CRITICAL",
- "environmentAccess": "READ_ONLY",
- "impactLevel": "INSIGNIFICANT",
- "dataAccessedOrProcessedList": [
- "string"
], - "latestSecurityReviews": [
- {
- "id": 1,
- "requestedAt": "2019-08-24T14:15:22Z",
- "reviewDeadlineAt": "2019-08-24T14:15:22Z",
- "decision": "APPROVED",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "user": {
- "id": null,
- "entryId": null,
- "email": null,
- "firstName": null,
- "lastName": null,
- "jobTitle": null,
- "avatarUrl": null,
- "drataTermsAgreedAt": null,
- "createdAt": null,
- "updatedAt": null,
- "roles": [ ],
- "backgroundChecks": [ ],
- "identities": [ ],
- "documents": [ ]
}, - "vendor": { },
- "requesterUser": {
- "id": null,
- "entryId": null,
- "email": null,
- "firstName": null,
- "lastName": null,
- "jobTitle": null,
- "avatarUrl": null,
- "drataTermsAgreedAt": null,
- "createdAt": null,
- "updatedAt": null,
- "roles": [ ],
- "backgroundChecks": [ ],
- "identities": [ ],
- "documents": [ ]
}
}
], - "riskCount": 0,
- "risksWithAnticipatedCompletionDateCount": 0,
- "vendorRelationshipContact": {
- "id": 1,
- "firstName": "Adam",
- "lastName": "Attack",
- "createdAt": "2025-01-08T21:18:10.846Z",
- "updatedAt": "2025-01-10T23:46:09.000Z"
}, - "catalogProductCandidateId": 1
}, - "requesterUser": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
}, - "riskCount": 0,
- "catalogProductCandidateId": 1
}
], - "page": 1,
- "limit": 10,
- "total": 100
}Create a new vendor resource in the account
🔒 Requires Vendors: Create Vendor permission.
💎 Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Created
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "name": "Acme",
- "category": "ENGINEERING",
- "risk": "MODERATE",
- "status": "UNDER_REVIEW",
- "critical": false,
- "isSubProcessor": false,
- "isSubProcessorActive": false,
- "userId": 1,
- "servicesProvided": "Perform security scans once a month",
- "dataStored": "resulting reports of security scans",
- "location": "San Diego",
- "hasPii": true,
- "passwordPolicy": "USERNAME_PASSWORD",
- "passwordRequiresMinLength": true,
- "passwordMinLength": 8,
- "passwordRequiresNumber": true,
- "passwordRequiresSymbol": true,
- "passwordMfaEnabled": true,
- "contactAtVendor": "John Doe",
- "notes": "Meeting once a month to adjust contract",
- "renewalDate": "2025-07-01T16:45:55.246Z",
- "renewalScheduleType": "ONE_YEAR",
- "confirmed": true,
- "type": "VENDOR",
- "accountId": 36,
- "operationalImpact": "IMPORTANT",
- "environmentAccess": "READ_ONLY",
- "impactLevel": "INSIGNIFICANT",
- "residualRiskLevelId": "1",
- "inherentRiskLevelId": "1",
- "dataAccessedOrProcessedList": [
- "FINANCIAL",
- "GENERAL"
], - "integrations": [
- 1,
- 2,
- 3
], - "cost": "1088",
- "excludeIds": [
- 1,
- 2
]
}{- "id": 1,
- "name": "Acme",
- "category": "ENGINEERING",
- "risk": "MODERATE",
- "type": "CONTRACTOR",
- "critical": false,
- "location": "USA",
- "trustCenterProvider": "DRATA",
- "servicesProvided": "Perform security scans once a month",
- "dataStored": "Resulting reports of security scans",
- "hasPii": true,
- "passwordPolicy": "USERNAME_PASSWORD",
- "passwordRequiresMinLength": true,
- "passwordMinLength": 8,
- "passwordRequiresNumber": true,
- "passwordRequiresSymbol": true,
- "passwordMfaEnabled": true,
- "contactAtVendor": "John Doe",
- "notes": "Meeting once a month to adjust contract",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": 1,
- "name": "Security Training",
- "type": "SEC_TRAINING",
- "renewalDate": "2026-10-27",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "documents": [
- {
- "id": 1,
- "name": "AWS SOC 2 2018",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "lastQuestionnaire": {
- "vendorId": 0,
- "sendAt": "string",
- "sentEmail": "string",
- "file": "string",
- "respondedAt": "string",
- "responseId": 0,
- "isManualUpload": true,
- "completedBy": "string"
}, - "isSubProcessor": false,
- "isSubProcessorActive": false,
- "archivedAt": "2025-07-01T16:45:55.246Z",
- "status": "ACTIVE",
- "renewalDate": "2020-07-06",
- "renewalScheduleType": "ONE_YEAR",
- "renewalDateStatus": "COMPLETED",
- "confirmedAt": "2025-07-01T16:45:55.246Z",
- "reviews": [
- {
- "id": 1,
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "reviewer": "John Doe",
- "reviewDate": "2025-07-01T16:45:55.246Z",
- "reportIssueDate": "2025-07-01T16:45:55.246Z",
- "socReport": "SOC_1",
- "socReportType1": true,
- "socReportType2": true,
- "socType1StartDate": "2025-07-01T16:45:55.246Z",
- "socType1EndDate": "2025-07-01T16:45:55.246Z",
- "socType2StartDate": "2025-07-01T16:45:55.246Z",
- "socType2EndDate": "2025-07-01T16:45:55.246Z",
- "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "User must proceed to...",
- "hasMaterialImpact": true,
- "cpaFirm": "CPA firm name",
- "cpaProcedurePerformed": "The following procedures were performed...",
- "subserviceOrganization": "Subservice Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "The following procedures were performed...",
- "trustServiceCategories": [
- {
- "id": 1,
- "category": "AVAILABILITY"
}
], - "userControls": [
- {
- "id": 1,
- "name": "End User Control 1",
- "inPlace": true
}
], - "services": [
- {
- "id": 1,
- "name": "Service 1"
}
], - "locations": [
- {
- "id": 1,
- "city": "San Diego",
- "stateCountry": "CA"
}
], - "findings": [
- {
- "id": 1,
- "description": "Finding 1"
}
]
}
], - "sharedAccountId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "isDrataUser": false,
- "events": 4,
- "integrations": [
- {
- "id": 1,
- "name": "Acme"
}
], - "cost": "1088",
- "operationalImpact": "CRITICAL",
- "environmentAccess": "READ_ONLY",
- "impactLevel": "INSIGNIFICANT",
- "dataAccessedOrProcessedList": [
- "string"
], - "latestSecurityReviews": [
- {
- "id": 1,
- "requestedAt": "2019-08-24T14:15:22Z",
- "reviewDeadlineAt": "2019-08-24T14:15:22Z",
- "decision": "APPROVED",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": null,
- "name": null,
- "type": null,
- "fileUrl": null,
- "renewalDate": null,
- "createdAt": null,
- "updatedAt": null
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "vendor": { },
- "requesterUser": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": null,
- "name": null,
- "type": null,
- "fileUrl": null,
- "renewalDate": null,
- "createdAt": null,
- "updatedAt": null
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}
}
], - "riskCount": 0,
- "risksWithAnticipatedCompletionDateCount": 0,
- "vendorRelationshipContact": {
- "id": 1,
- "firstName": "Adam",
- "lastName": "Attack",
- "createdAt": "2025-01-08T21:18:10.846Z",
- "updatedAt": "2025-01-10T23:46:09.000Z"
}, - "catalogProductCandidateId": 1
}Get vendors stats given inclusion and exclusion arrays
🔒 Requires Vendors: Get Vendors Statistics permission.
💎 Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "reminder": [
- {
- "key": "RENEWAL_DUE",
- "amount": 1
}, - {
- "key": "RENEWAL_DUE_SOON",
- "amount": 1
}
], - "hasPii": [
- {
- "key": "true",
- "amount": 1
}, - {
- "key": "false",
- "amount": 1
}
], - "businessUnits": [
- {
- "key": "ENGINEERING",
- "amount": 118
}, - {
- "key": "PRODUCT",
- "amount": 2
}
], - "passwordPolicy": [
- {
- "key": "USERNAME_PASSWORD",
- "amount": 118
}, - {
- "key": "SSO",
- "amount": 2
}, - {
- "key": "NONE",
- "amount": 2
}, - {
- "key": "LDAP",
- "amount": 2
}
], - "status": [
- {
- "key": "ACTIVE",
- "amount": 118
}, - {
- "key": "UNDER_REVIEW",
- "amount": 1
}
], - "isCritical": [
- {
- "key": "Yes",
- "amount": 10
}, - {
- "key": "No",
- "amount": 20
}
], - "isSubProcessor": [
- {
- "key": "true",
- "amount": 10
}, - {
- "key": "false",
- "amount": 20
}
], - "type": [
- {
- "key": "CONTRACTOR",
- "amount": 1
}, - {
- "key": "NONE",
- "amount": 2
}, - {
- "key": "OTHER",
- "amount": 3
}, - {
- "key": "PARTNER",
- "amount": 4
}, - {
- "key": "SUPPLIER",
- "amount": 4
}, - {
- "key": "VENDOR",
- "amount": 5
}
], - "risk": [
- {
- "key": "HIGH",
- "amount": 118
}, - {
- "key": "MODERATE",
- "amount": 2
}, - {
- "key": "LOW",
- "amount": 2
}, - {
- "key": "NONE",
- "amount": 2
}
], - "impactLevel": [
- {
- "key": "CRITICAL",
- "amount": 7
}, - {
- "key": "MAJOR",
- "amount": 12
}, - {
- "key": "MODERATE",
- "amount": 1
}, - {
- "key": "MINOR",
- "amount": 5
}, - {
- "key": "INSIGNIFICANT",
- "amount": 21
}, - {
- "key": "UNSCORED",
- "amount": 0
}
]
}Get a vendor
🔒 Requires Vendors: Get Vendor permission.
💎 Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "name": "Acme",
- "category": "ENGINEERING",
- "risk": "MODERATE",
- "type": "CONTRACTOR",
- "critical": false,
- "location": "USA",
- "trustCenterProvider": "DRATA",
- "servicesProvided": "Perform security scans once a month",
- "dataStored": "Resulting reports of security scans",
- "hasPii": true,
- "passwordPolicy": "USERNAME_PASSWORD",
- "passwordRequiresMinLength": true,
- "passwordMinLength": 8,
- "passwordRequiresNumber": true,
- "passwordRequiresSymbol": true,
- "passwordMfaEnabled": true,
- "contactAtVendor": "John Doe",
- "notes": "Meeting once a month to adjust contract",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": 1,
- "name": "Security Training",
- "type": "SEC_TRAINING",
- "renewalDate": "2026-10-27",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "documents": [
- {
- "id": 1,
- "name": "AWS SOC 2 2018",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "lastQuestionnaire": {
- "vendorId": 0,
- "sendAt": "string",
- "sentEmail": "string",
- "file": "string",
- "respondedAt": "string",
- "responseId": 0,
- "isManualUpload": true,
- "completedBy": "string"
}, - "isSubProcessor": false,
- "isSubProcessorActive": false,
- "archivedAt": "2025-07-01T16:45:55.246Z",
- "status": "ACTIVE",
- "renewalDate": "2020-07-06",
- "renewalScheduleType": "ONE_YEAR",
- "renewalDateStatus": "COMPLETED",
- "confirmedAt": "2025-07-01T16:45:55.246Z",
- "reviews": [
- {
- "id": 1,
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "reviewer": "John Doe",
- "reviewDate": "2025-07-01T16:45:55.246Z",
- "reportIssueDate": "2025-07-01T16:45:55.246Z",
- "socReport": "SOC_1",
- "socReportType1": true,
- "socReportType2": true,
- "socType1StartDate": "2025-07-01T16:45:55.246Z",
- "socType1EndDate": "2025-07-01T16:45:55.246Z",
- "socType2StartDate": "2025-07-01T16:45:55.246Z",
- "socType2EndDate": "2025-07-01T16:45:55.246Z",
- "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "User must proceed to...",
- "hasMaterialImpact": true,
- "cpaFirm": "CPA firm name",
- "cpaProcedurePerformed": "The following procedures were performed...",
- "subserviceOrganization": "Subservice Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "The following procedures were performed...",
- "trustServiceCategories": [
- {
- "id": 1,
- "category": "AVAILABILITY"
}
], - "userControls": [
- {
- "id": 1,
- "name": "End User Control 1",
- "inPlace": true
}
], - "services": [
- {
- "id": 1,
- "name": "Service 1"
}
], - "locations": [
- {
- "id": 1,
- "city": "San Diego",
- "stateCountry": "CA"
}
], - "findings": [
- {
- "id": 1,
- "description": "Finding 1"
}
]
}
], - "sharedAccountId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "isDrataUser": false,
- "events": 4,
- "integrations": [
- {
- "id": 1,
- "name": "Acme"
}
], - "cost": "1088",
- "operationalImpact": "CRITICAL",
- "environmentAccess": "READ_ONLY",
- "impactLevel": "INSIGNIFICANT",
- "dataAccessedOrProcessedList": [
- "string"
], - "latestSecurityReviews": [
- {
- "id": 1,
- "requestedAt": "2019-08-24T14:15:22Z",
- "reviewDeadlineAt": "2019-08-24T14:15:22Z",
- "decision": "APPROVED",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": null,
- "name": null,
- "type": null,
- "fileUrl": null,
- "renewalDate": null,
- "createdAt": null,
- "updatedAt": null
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "vendor": { },
- "requesterUser": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": null,
- "name": null,
- "type": null,
- "fileUrl": null,
- "renewalDate": null,
- "createdAt": null,
- "updatedAt": null
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}
}
], - "riskCount": 0,
- "risksWithAnticipatedCompletionDateCount": 0,
- "vendorRelationshipContact": {
- "id": 1,
- "firstName": "Adam",
- "lastName": "Attack",
- "createdAt": "2025-01-08T21:18:10.846Z",
- "updatedAt": "2025-01-10T23:46:09.000Z"
}, - "catalogProductCandidateId": 1
}Update a vendor
🔒 Requires Vendors: Update Vendor permission.
💎 Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "name": "Acme",
- "category": "ENGINEERING",
- "risk": "MODERATE",
- "status": "UNDER_REVIEW",
- "critical": false,
- "isSubProcessor": false,
- "isSubProcessorActive": false,
- "userId": 1,
- "servicesProvided": "Perform security scans once a month",
- "dataStored": "resulting reports of security scans",
- "location": "San Diego",
- "hasPii": true,
- "passwordPolicy": "USERNAME_PASSWORD",
- "passwordRequiresMinLength": true,
- "passwordMinLength": 8,
- "passwordRequiresNumber": true,
- "passwordRequiresSymbol": true,
- "passwordMfaEnabled": true,
- "contactAtVendor": "John Doe",
- "notes": "Meeting once a month to adjust contract",
- "renewalDate": "2025-07-01T16:45:55.246Z",
- "renewalScheduleType": "ONE_YEAR",
- "confirmed": true,
- "type": "VENDOR",
- "vendorTypeId": "1",
- "accountId": 36,
- "operationalImpact": "IMPORTANT",
- "environmentAccess": "READ_ONLY",
- "impactLevel": "INSIGNIFICANT",
- "residualRiskLevelId": "1",
- "inherentRiskLevelId": "1",
- "dataAccessedOrProcessedList": [
- "FINANCIAL",
- "GENERAL"
], - "integrations": [
- 1,
- 2,
- 3
], - "cost": "1088",
- "excludeIds": [
- 1,
- 2
]
}{- "id": 1,
- "name": "Acme",
- "category": "ENGINEERING",
- "risk": "MODERATE",
- "type": "CONTRACTOR",
- "critical": false,
- "location": "USA",
- "trustCenterProvider": "DRATA",
- "servicesProvided": "Perform security scans once a month",
- "dataStored": "Resulting reports of security scans",
- "hasPii": true,
- "passwordPolicy": "USERNAME_PASSWORD",
- "passwordRequiresMinLength": true,
- "passwordMinLength": 8,
- "passwordRequiresNumber": true,
- "passwordRequiresSymbol": true,
- "passwordMfaEnabled": true,
- "contactAtVendor": "John Doe",
- "notes": "Meeting once a month to adjust contract",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": 1,
- "name": "Security Training",
- "type": "SEC_TRAINING",
- "renewalDate": "2026-10-27",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "documents": [
- {
- "id": 1,
- "name": "AWS SOC 2 2018",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "lastQuestionnaire": {
- "vendorId": 0,
- "sendAt": "string",
- "sentEmail": "string",
- "file": "string",
- "respondedAt": "string",
- "responseId": 0,
- "isManualUpload": true,
- "completedBy": "string"
}, - "isSubProcessor": false,
- "isSubProcessorActive": false,
- "archivedAt": "2025-07-01T16:45:55.246Z",
- "status": "ACTIVE",
- "renewalDate": "2020-07-06",
- "renewalScheduleType": "ONE_YEAR",
- "renewalDateStatus": "COMPLETED",
- "confirmedAt": "2025-07-01T16:45:55.246Z",
- "reviews": [
- {
- "id": 1,
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "reviewer": "John Doe",
- "reviewDate": "2025-07-01T16:45:55.246Z",
- "reportIssueDate": "2025-07-01T16:45:55.246Z",
- "socReport": "SOC_1",
- "socReportType1": true,
- "socReportType2": true,
- "socType1StartDate": "2025-07-01T16:45:55.246Z",
- "socType1EndDate": "2025-07-01T16:45:55.246Z",
- "socType2StartDate": "2025-07-01T16:45:55.246Z",
- "socType2EndDate": "2025-07-01T16:45:55.246Z",
- "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "User must proceed to...",
- "hasMaterialImpact": true,
- "cpaFirm": "CPA firm name",
- "cpaProcedurePerformed": "The following procedures were performed...",
- "subserviceOrganization": "Subservice Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "The following procedures were performed...",
- "trustServiceCategories": [
- {
- "id": 1,
- "category": "AVAILABILITY"
}
], - "userControls": [
- {
- "id": 1,
- "name": "End User Control 1",
- "inPlace": true
}
], - "services": [
- {
- "id": 1,
- "name": "Service 1"
}
], - "locations": [
- {
- "id": 1,
- "city": "San Diego",
- "stateCountry": "CA"
}
], - "findings": [
- {
- "id": 1,
- "description": "Finding 1"
}
]
}
], - "sharedAccountId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "isDrataUser": false,
- "events": 4,
- "integrations": [
- {
- "id": 1,
- "name": "Acme"
}
], - "cost": "1088",
- "operationalImpact": "CRITICAL",
- "environmentAccess": "READ_ONLY",
- "impactLevel": "INSIGNIFICANT",
- "dataAccessedOrProcessedList": [
- "string"
], - "latestSecurityReviews": [
- {
- "id": 1,
- "requestedAt": "2019-08-24T14:15:22Z",
- "reviewDeadlineAt": "2019-08-24T14:15:22Z",
- "decision": "APPROVED",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": null,
- "name": null,
- "type": null,
- "fileUrl": null,
- "renewalDate": null,
- "createdAt": null,
- "updatedAt": null
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "vendor": { },
- "requesterUser": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": null,
- "name": null,
- "type": null,
- "fileUrl": null,
- "renewalDate": null,
- "createdAt": null,
- "updatedAt": null
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}
}
], - "riskCount": 0,
- "risksWithAnticipatedCompletionDateCount": 0,
- "vendorRelationshipContact": {
- "id": 1,
- "firstName": "Adam",
- "lastName": "Attack",
- "createdAt": "2025-01-08T21:18:10.846Z",
- "updatedAt": "2025-01-10T23:46:09.000Z"
}, - "catalogProductCandidateId": 1
}Delete a vendor
🔒 Requires Vendors: Delete Vendor permission.
💎 Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "statusCode": 0,
- "message": "string",
- "code": 0,
- "debugInfo": {
- "name": "string",
- "message": "string",
- "stack": "string"
}, - "providerError": {
- "provider": "string",
- "status": 0,
- "code": "string",
- "message": "string",
- "details": { }
}
}Upload vendor documents
🔒 Requires Vendors: Upload Vendor Report permission.
💎 Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Created
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
The file was too large to upload
Internal server error
Third party system was unavailable
{- "data": [
- {
- "id": 1,
- "name": "Acme",
- "category": "ENGINEERING",
- "risk": "MODERATE",
- "type": "CONTRACTOR",
- "critical": false,
- "location": "USA",
- "trustCenterProvider": "DRATA",
- "servicesProvided": "Perform security scans once a month",
- "dataStored": "Resulting reports of security scans",
- "hasPii": true,
- "passwordPolicy": "USERNAME_PASSWORD",
- "passwordRequiresMinLength": true,
- "passwordMinLength": 8,
- "passwordRequiresNumber": true,
- "passwordRequiresSymbol": true,
- "passwordMfaEnabled": true,
- "contactAtVendor": "John Doe",
- "notes": "Meeting once a month to adjust contract",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": null,
- "name": null,
- "type": null,
- "fileUrl": null,
- "renewalDate": null,
- "createdAt": null,
- "updatedAt": null
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "vendorRelationshipContact": {
- "id": 1,
- "firstName": "Adam",
- "lastName": "Attack",
- "createdAt": "2025-01-08T21:18:10.846Z",
- "updatedAt": "2025-01-10T23:46:09.000Z"
}, - "documents": [
- {
- "id": 1,
- "name": "AWS SOC 2 2018",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "lastQuestionnaire": {
- "vendorId": 0,
- "sendAt": "string",
- "sentEmail": "string",
- "file": "string",
- "respondedAt": "string",
- "responseId": 0,
- "isManualUpload": true,
- "completedBy": "string"
}, - "isSubProcessor": false,
- "isSubProcessorActive": false,
- "archivedAt": "2025-07-01T16:45:55.246Z",
- "status": "ACTIVE",
- "renewalDate": "2020-07-06",
- "renewalScheduleType": "ONE_YEAR",
- "renewalDateStatus": "COMPLETED",
- "confirmedAt": "2025-07-01T16:45:55.246Z",
- "reviews": [
- {
- "id": 1,
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "reviewer": "John Doe",
- "reviewDate": "2025-07-01T16:45:55.246Z",
- "reportIssueDate": "2025-07-01T16:45:55.246Z",
- "socReport": "SOC_1",
- "socReportType1": true,
- "socReportType2": true,
- "socType1StartDate": "2025-07-01T16:45:55.246Z",
- "socType1EndDate": "2025-07-01T16:45:55.246Z",
- "socType2StartDate": "2025-07-01T16:45:55.246Z",
- "socType2EndDate": "2025-07-01T16:45:55.246Z",
- "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "User must proceed to...",
- "hasMaterialImpact": true,
- "cpaFirm": "CPA firm name",
- "cpaProcedurePerformed": "The following procedures were performed...",
- "subserviceOrganization": "Subservice Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "The following procedures were performed...",
- "trustServiceCategories": [
- {
- "id": 1,
- "category": "AVAILABILITY"
}
], - "userControls": [
- {
- "id": 1,
- "name": "End User Control 1",
- "inPlace": true
}
], - "services": [
- {
- "id": 1,
- "name": "Service 1"
}
], - "locations": [
- {
- "id": 1,
- "city": "San Diego",
- "stateCountry": "CA"
}
], - "findings": [
- {
- "id": 1,
- "description": "Finding 1"
}
]
}
], - "sharedAccountId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "isDrataUser": false,
- "events": 4,
- "impactLevel": "INSIGNIFICANT",
- "securityReview": {
- "id": 1,
- "requestedAt": "2019-08-24T14:15:22Z",
- "reviewDeadlineAt": "2019-08-24T14:15:22Z",
- "decision": "APPROVED",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": null,
- "clientType": null,
- "state": null,
- "connected": null,
- "connectedAt": null,
- "failedAt": null,
- "companyId": null,
- "assignmentId": null,
- "user": null,
- "accountId": null,
- "clientId": null,
- "clientAlias": null,
- "manuallyUpdatedAt": null,
- "aliasUpdatedAt": null,
- "deletedAt": null,
- "requestorId": null,
- "product": { },
- "writeAccessEnabled": null,
- "sourcePreference": null,
- "securityLabel": null,
- "jqlQuery": null,
- "authorized": null,
- "workspaces": [ ],
- "providerTypes": [ ],
- "code": null,
- "groupIdList": [ ]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- null
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "vendor": {
- "id": 1,
- "name": "Acme",
- "category": "ENGINEERING",
- "risk": "MODERATE",
- "type": "CONTRACTOR",
- "critical": false,
- "location": "USA",
- "trustCenterProvider": "DRATA",
- "servicesProvided": "Perform security scans once a month",
- "dataStored": "Resulting reports of security scans",
- "hasPii": true,
- "passwordPolicy": "USERNAME_PASSWORD",
- "passwordRequiresMinLength": true,
- "passwordMinLength": 8,
- "passwordRequiresNumber": true,
- "passwordRequiresSymbol": true,
- "passwordMfaEnabled": true,
- "contactAtVendor": "John Doe",
- "notes": "Meeting once a month to adjust contract",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": null,
- "userId": null,
- "status": null,
- "caseId": null,
- "caseInvitationId": null,
- "url": null,
- "manualCheckDate": null,
- "manuallyCheckUrl": null,
- "type": null,
- "source": null,
- "reportData": null,
- "user": null,
- "outOfScopeReason": null,
- "outOfScopeAt": null,
- "invitationEmail": null,
- "linkedAt": null,
- "createdAt": null,
- "updatedAt": null
}
], - "identities": [
- {
- "id": null,
- "identityId": null,
- "username": null,
- "connectedAt": null,
- "disconnectedAt": null,
- "hasMfa": null,
- "user": null,
- "connection": null,
- "hasIdp": null,
- "secondaryEmail": null,
- "firstName": null,
- "lastName": null,
- "startedAt": null,
- "separatedAt": null,
- "isContractor": null,
- "jobTitle": null,
- "managerId": null,
- "managerName": null
}
], - "documents": [
- {
- "data": [ ],
- "page": null,
- "limit": null,
- "total": null
}
]
}, - "documents": [
- {
- "id": 1,
- "name": "AWS SOC 2 2018",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "lastQuestionnaire": {
- "vendorId": 0,
- "sendAt": "string",
- "sentEmail": "string",
- "file": "string",
- "respondedAt": "string",
- "responseId": 0,
- "isManualUpload": true,
- "completedBy": "string"
}, - "isSubProcessor": false,
- "isSubProcessorActive": false,
- "archivedAt": "2025-07-01T16:45:55.246Z",
- "status": "ACTIVE",
- "renewalDate": "2020-07-06",
- "renewalScheduleType": "ONE_YEAR",
- "renewalDateStatus": "COMPLETED",
- "confirmedAt": "2025-07-01T16:45:55.246Z",
- "reviews": [
- {
- "id": 1,
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "reviewer": "John Doe",
- "reviewDate": "2025-07-01T16:45:55.246Z",
- "reportIssueDate": "2025-07-01T16:45:55.246Z",
- "socReport": "SOC_1",
- "socReportType1": true,
- "socReportType2": true,
- "socType1StartDate": "2025-07-01T16:45:55.246Z",
- "socType1EndDate": "2025-07-01T16:45:55.246Z",
- "socType2StartDate": "2025-07-01T16:45:55.246Z",
- "socType2EndDate": "2025-07-01T16:45:55.246Z",
- "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "User must proceed to...",
- "hasMaterialImpact": true,
- "cpaFirm": "CPA firm name",
- "cpaProcedurePerformed": "The following procedures were performed...",
- "subserviceOrganization": "Subservice Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "The following procedures were performed...",
- "trustServiceCategories": [
- null
], - "userControls": [
- null
], - "services": [
- null
], - "locations": [
- null
], - "findings": [
- null
]
}
], - "sharedAccountId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "isDrataUser": false,
- "events": 4,
- "integrations": [
- {
- "id": 1,
- "name": "Acme"
}
], - "cost": "1088",
- "operationalImpact": "CRITICAL",
- "environmentAccess": "READ_ONLY",
- "impactLevel": "INSIGNIFICANT",
- "dataAccessedOrProcessedList": [
- "string"
], - "latestSecurityReviews": [
- {
- "id": 1,
- "requestedAt": "2019-08-24T14:15:22Z",
- "reviewDeadlineAt": "2019-08-24T14:15:22Z",
- "decision": "APPROVED",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "user": {
- "id": null,
- "entryId": null,
- "email": null,
- "firstName": null,
- "lastName": null,
- "jobTitle": null,
- "avatarUrl": null,
- "drataTermsAgreedAt": null,
- "createdAt": null,
- "updatedAt": null,
- "roles": [ ],
- "backgroundChecks": [ ],
- "identities": [ ],
- "documents": [ ]
}, - "vendor": { },
- "requesterUser": {
- "id": null,
- "entryId": null,
- "email": null,
- "firstName": null,
- "lastName": null,
- "jobTitle": null,
- "avatarUrl": null,
- "drataTermsAgreedAt": null,
- "createdAt": null,
- "updatedAt": null,
- "roles": [ ],
- "backgroundChecks": [ ],
- "identities": [ ],
- "documents": [ ]
}
}
], - "riskCount": 0,
- "risksWithAnticipatedCompletionDateCount": 0,
- "vendorRelationshipContact": {
- "id": 1,
- "firstName": "Adam",
- "lastName": "Attack",
- "createdAt": "2025-01-08T21:18:10.846Z",
- "updatedAt": "2025-01-10T23:46:09.000Z"
}, - "catalogProductCandidateId": 1
}, - "requesterUser": {
- "id": 1,
- "firstName": "Sally",
- "lastName": "Smith",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
}, - "riskCount": 0,
- "catalogProductCandidateId": 1
}
], - "page": 1,
- "limit": 10,
- "total": 100
}Update vendor status to archive or activate a vendor
🔒 Requires Vendors: Update Vendor's Status permission.
💎 Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Successful
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "vendorStatus": "ARCHIVED"
}{- "id": 1,
- "name": "Acme",
- "category": "ENGINEERING",
- "risk": "MODERATE",
- "type": "CONTRACTOR",
- "critical": false,
- "location": "USA",
- "trustCenterProvider": "DRATA",
- "servicesProvided": "Perform security scans once a month",
- "dataStored": "Resulting reports of security scans",
- "hasPii": true,
- "passwordPolicy": "USERNAME_PASSWORD",
- "passwordRequiresMinLength": true,
- "passwordMinLength": 8,
- "passwordRequiresNumber": true,
- "passwordRequiresSymbol": true,
- "passwordMfaEnabled": true,
- "contactAtVendor": "John Doe",
- "notes": "Meeting once a month to adjust contract",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": 1,
- "name": "Security Training",
- "type": "SEC_TRAINING",
- "renewalDate": "2026-10-27",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "documents": [
- {
- "id": 1,
- "name": "AWS SOC 2 2018",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "lastQuestionnaire": {
- "vendorId": 0,
- "sendAt": "string",
- "sentEmail": "string",
- "file": "string",
- "respondedAt": "string",
- "responseId": 0,
- "isManualUpload": true,
- "completedBy": "string"
}, - "isSubProcessor": false,
- "isSubProcessorActive": false,
- "archivedAt": "2025-07-01T16:45:55.246Z",
- "status": "ACTIVE",
- "renewalDate": "2020-07-06",
- "renewalScheduleType": "ONE_YEAR",
- "renewalDateStatus": "COMPLETED",
- "confirmedAt": "2025-07-01T16:45:55.246Z",
- "reviews": [
- {
- "id": 1,
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "reviewer": "John Doe",
- "reviewDate": "2025-07-01T16:45:55.246Z",
- "reportIssueDate": "2025-07-01T16:45:55.246Z",
- "socReport": "SOC_1",
- "socReportType1": true,
- "socReportType2": true,
- "socType1StartDate": "2025-07-01T16:45:55.246Z",
- "socType1EndDate": "2025-07-01T16:45:55.246Z",
- "socType2StartDate": "2025-07-01T16:45:55.246Z",
- "socType2EndDate": "2025-07-01T16:45:55.246Z",
- "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "User must proceed to...",
- "hasMaterialImpact": true,
- "cpaFirm": "CPA firm name",
- "cpaProcedurePerformed": "The following procedures were performed...",
- "subserviceOrganization": "Subservice Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "The following procedures were performed...",
- "trustServiceCategories": [
- {
- "id": 1,
- "category": "AVAILABILITY"
}
], - "userControls": [
- {
- "id": 1,
- "name": "End User Control 1",
- "inPlace": true
}
], - "services": [
- {
- "id": 1,
- "name": "Service 1"
}
], - "locations": [
- {
- "id": 1,
- "city": "San Diego",
- "stateCountry": "CA"
}
], - "findings": [
- {
- "id": 1,
- "description": "Finding 1"
}
]
}
], - "sharedAccountId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "isDrataUser": false,
- "events": 4,
- "integrations": [
- {
- "id": 1,
- "name": "Acme"
}
], - "cost": "1088",
- "operationalImpact": "CRITICAL",
- "environmentAccess": "READ_ONLY",
- "impactLevel": "INSIGNIFICANT",
- "dataAccessedOrProcessedList": [
- "string"
], - "latestSecurityReviews": [
- {
- "id": 1,
- "requestedAt": "2019-08-24T14:15:22Z",
- "reviewDeadlineAt": "2019-08-24T14:15:22Z",
- "decision": "APPROVED",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": null,
- "name": null,
- "type": null,
- "fileUrl": null,
- "renewalDate": null,
- "createdAt": null,
- "updatedAt": null
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "vendor": { },
- "requesterUser": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": null,
- "name": null,
- "type": null,
- "fileUrl": null,
- "renewalDate": null,
- "createdAt": null,
- "updatedAt": null
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}
}
], - "riskCount": 0,
- "risksWithAnticipatedCompletionDateCount": 0,
- "vendorRelationshipContact": {
- "id": 1,
- "firstName": "Adam",
- "lastName": "Attack",
- "createdAt": "2025-01-08T21:18:10.846Z",
- "updatedAt": "2025-01-10T23:46:09.000Z"
}, - "catalogProductCandidateId": 1
}List vendor questionnaires by vendor id
🔒 Requires Vendors: List Vendor Questionnaire permission.
💎 Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "data": [
- {
- "id": 1,
- "completedBy": "Acme",
- "isCompleted": "true",
- "dateSent": "2025-07-01T16:45:55.246Z",
- "isManualUpload": "true",
- "responseId": 1,
- "title": "Vendor Questionnaire"
}
], - "page": 1,
- "limit": 10,
- "total": 100
}Send questionnaire to recipient email
🔒 Requires Vendors: Send Questionnaire to Vendor permission.
💎 Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Created
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
You must accept the Drata terms and conditions to use the API
Internal server error
{- "questionnaireId": 1,
- "emailSubject": "Drata is conducting a security review of you.",
- "emailContent": "Hi,\n\nWe'd like to conduct a security review and would like some information from you. Use this link to complete the questionnaire.\n\nThank you.",
- "securityReviewId": 1
}{- "data": [
- {
- "id": 1,
- "completedBy": "Acme",
- "isCompleted": "true",
- "dateSent": "2025-07-01T16:45:55.246Z",
- "isManualUpload": "true",
- "responseId": 1,
- "title": "Vendor Questionnaire"
}
], - "page": 1,
- "limit": 10,
- "total": 100
}Upload security questionnaire
🔒 Requires Vendors: Upload Security Questionnaire permission.
💎 Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Created
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "id": 1,
- "completedBy": "Acme",
- "isCompleted": "true",
- "dateSent": "2025-07-01T16:45:55.246Z",
- "isManualUpload": "true",
- "responseId": 1,
- "title": "Vendor Questionnaire"
}Create a new vendor's security review
🔒 Requires Vendors: Create Security Review permission.
💎 Requires your account have the TPRM Standard, Third Party Risk Management Pro, TPRM Pro Max feature. Contact your Account Manager for help upgrading.
Created
Malformed data and/or validation errors
Invalid Authorization
You must upgrade your plan to use this feature
You are not allowed to perform this action
Not Found
You must accept the Drata terms and conditions to use the API
Internal server error
{- "title": "Security review title",
- "reviewDeadlineAt": "2025-07-01T16:45:55.246Z",
- "requestedAt": "2025-07-01T16:45:55.246Z",
- "securityReviewStatus": "NOT_YET_STARTED",
- "securityReviewType": "SECURITY",
- "requesterUserId": 1
}{- "id": 1,
- "requestedAt": "2019-08-24T14:15:22Z",
- "reviewDeadlineAt": "2019-08-24T14:15:22Z",
- "decision": "APPROVED",
- "note": "string",
- "status": "NOT_YET_STARTED",
- "type": "SECURITY",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": 1,
- "name": "Security Training",
- "type": "SEC_TRAINING",
- "renewalDate": "2026-10-27",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "vendor": {
- "id": 1,
- "name": "Acme",
- "category": "ENGINEERING",
- "risk": "MODERATE",
- "type": "CONTRACTOR",
- "critical": false,
- "location": "USA",
- "trustCenterProvider": "DRATA",
- "servicesProvided": "Perform security scans once a month",
- "dataStored": "Resulting reports of security scans",
- "hasPii": true,
- "passwordPolicy": "USERNAME_PASSWORD",
- "passwordRequiresMinLength": true,
- "passwordMinLength": 8,
- "passwordRequiresNumber": true,
- "passwordRequiresSymbol": true,
- "passwordMfaEnabled": true,
- "contactAtVendor": "John Doe",
- "notes": "Meeting once a month to adjust contract",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "user": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": 1,
- "name": "Security Training",
- "type": "SEC_TRAINING",
- "renewalDate": "2026-10-27",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}, - "documents": [
- {
- "id": 1,
- "name": "AWS SOC 2 2018",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "lastQuestionnaire": {
- "vendorId": 0,
- "sendAt": "string",
- "sentEmail": "string",
- "file": "string",
- "respondedAt": "string",
- "responseId": 0,
- "isManualUpload": true,
- "completedBy": "string"
}, - "isSubProcessor": false,
- "isSubProcessorActive": false,
- "archivedAt": "2025-07-01T16:45:55.246Z",
- "status": "ACTIVE",
- "renewalDate": "2020-07-06",
- "renewalScheduleType": "ONE_YEAR",
- "renewalDateStatus": "COMPLETED",
- "confirmedAt": "2025-07-01T16:45:55.246Z",
- "reviews": [
- {
- "id": 1,
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "reviewer": "John Doe",
- "reviewDate": "2025-07-01T16:45:55.246Z",
- "reportIssueDate": "2025-07-01T16:45:55.246Z",
- "socReport": "SOC_1",
- "socReportType1": true,
- "socReportType2": true,
- "socType1StartDate": "2025-07-01T16:45:55.246Z",
- "socType1EndDate": "2025-07-01T16:45:55.246Z",
- "socType2StartDate": "2025-07-01T16:45:55.246Z",
- "socType2EndDate": "2025-07-01T16:45:55.246Z",
- "reportOpinion": "UNQUALIFIED",
- "encompassBusinessNeeds": true,
- "followUpActivity": "User must proceed to...",
- "hasMaterialImpact": true,
- "cpaFirm": "CPA firm name",
- "cpaProcedurePerformed": "The following procedures were performed...",
- "subserviceOrganization": "Subservice Inc.",
- "subserviceOrganizationUsingInclusiveMethod": true,
- "subserviceOrganizationProcedurePerformed": "The following procedures were performed...",
- "trustServiceCategories": [
- {
- "id": 1,
- "category": "AVAILABILITY"
}
], - "userControls": [
- {
- "id": 1,
- "name": "End User Control 1",
- "inPlace": true
}
], - "services": [
- {
- "id": 1,
- "name": "Service 1"
}
], - "locations": [
- {
- "id": 1,
- "city": "San Diego",
- "stateCountry": "CA"
}
], - "findings": [
- {
- "id": 1,
- "description": "Finding 1"
}
]
}
], - "sharedAccountId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "isDrataUser": false,
- "events": 4,
- "integrations": [
- {
- "id": 1,
- "name": "Acme"
}
], - "cost": "1088",
- "operationalImpact": "CRITICAL",
- "environmentAccess": "READ_ONLY",
- "impactLevel": "INSIGNIFICANT",
- "dataAccessedOrProcessedList": [
- "string"
], - "latestSecurityReviews": [
- { }
], - "riskCount": 0,
- "risksWithAnticipatedCompletionDateCount": 0,
- "vendorRelationshipContact": {
- "id": 1,
- "firstName": "Adam",
- "lastName": "Attack",
- "createdAt": "2025-01-08T21:18:10.846Z",
- "updatedAt": "2025-01-10T23:46:09.000Z"
}, - "catalogProductCandidateId": 1
}, - "requesterUser": {
- "id": 1,
- "entryId": "aaaaaaaa-bbbb-0000-cccc-dddddddddddd",
- "firstName": "Sally",
- "lastName": "Smith",
- "jobTitle": "CEO",
- "drataTermsAgreedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z",
- "roles": [
- "ROLE",
- "ANOTHER_ROLE"
], - "backgroundChecks": [
- {
- "id": 1,
- "userId": 1,
- "status": "OK",
- "caseId": "abc123",
- "caseInvitationId": "abc123",
- "manualCheckDate": "2020-07-06",
- "manuallyCheckUrl": "url.com",
- "type": "CERTN",
- "source": "DRATA",
- "reportData": "string",
- "user": { },
- "outOfScopeReason": "abc123",
- "outOfScopeAt": "2025-07-01T16:45:55.246Z",
- "linkedAt": "2025-07-01T16:45:55.246Z",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "identities": [
- {
- "id": 1,
- "identityId": "1a2b3c",
- "username": "Username",
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "disconnectedAt": "2025-07-01T16:45:55.246Z",
- "hasMfa": true,
- "user": { },
- "connection": {
- "id": "1",
- "clientType": "GOOGLE",
- "state": "ACTIVE",
- "connected": false,
- "connectedAt": "2025-07-01T16:45:55.246Z",
- "failedAt": "2025-07-01T16:45:55.246Z",
- "companyId": "12341234",
- "assignmentId": "FLk12AsS",
- "user": { },
- "accountId": "string",
- "clientId": "abc123",
- "clientAlias": "My-connection-alias-1",
- "manuallyUpdatedAt": "2025-07-01T16:45:55.246Z",
- "aliasUpdatedAt": "2025-07-01T16:45:55.246Z",
- "deletedAt": "2025-07-01T16:45:55.246Z",
- "requestorId": "328d3016-71f3-4485-af20-06ce8044da18",
- "product": { },
- "writeAccessEnabled": false,
- "sourcePreference": "LABEL",
- "securityLabel": "Jira Security Label",
- "jqlQuery": "project = IT AND type = \"Offboarding\"",
- "authorized": true,
- "workspaces": [
- {
- "id": 1,
- "name": "Drata",
- "description": "Platform to track SOC 2 compliance within the organization",
- "howItWorks": null,
- "primary": true
}
], - "providerTypes": [
- 5
], - "code": 10010,
- "groupIdList": [
- "00g1a2b3c4d5e6f7g8h9",
- "00g9h8g7f6e5d4c3b2a1"
]
}, - "hasIdp": true,
- "firstName": "John",
- "lastName": "Doe",
- "startedAt": "2025-07-01T16:45:55.246Z",
- "separatedAt": "2025-07-01T16:45:55.246Z",
- "isContractor": true,
- "jobTitle": "Engineer",
- "managerId": "x00jk12-2312",
- "managerName": "string"
}
], - "documents": [
- {
- "data": [
- {
- "id": 1,
- "name": "Security Training",
- "type": "SEC_TRAINING",
- "renewalDate": "2026-10-27",
- "createdAt": "2025-07-01T16:45:55.246Z",
- "updatedAt": "2025-07-01T16:45:55.246Z"
}
], - "page": 1,
- "limit": 10,
- "total": 100
}
]
}
}