> ## Documentation Index > Fetch the complete documentation index at: https://developer.vanta.com/llms.txt > Use this file to discover all available pages before exploring further. # List assessments by vendor ID > Returns a vendor's assessments across all assessment types. ## OpenAPI ````yaml /reference/manage-vanta.json get /vendors/{vendorId}/assessments openapi: 3.0.0 info: title: Manage Vanta version: 1.0.0 description: >- The REST API lets customers query and mutate Vanta's data. Use this API to automate bulk actions, query data for custom workflows and dashboards, and bolster your security operations **Note for Vanta Gov (FedRAMP) customers:** Select `Vanta Gov (FedRAMP)` from the server dropdown to issue requests against `https://api.vanta-gov.com`. The OAuth token URL shown below defaults to the commercial host — replace it with `https://api.vanta-gov.com/oauth/token`. termsOfService: https://www.vanta.com/terms license: name: UNLICENSED contact: name: API Support url: https://help.vanta.com/ email: support@vanta.com servers: - url: https://api.vanta.com/v1 description: Vanta (Commercial) - url: https://api.vanta-gov.com/v1 description: Vanta Gov (FedRAMP) security: [] paths: /vendors/{vendorId}/assessments: get: tags: - Vendors summary: List assessments by vendor ID description: Returns a vendor's assessments across all assessment types. operationId: GetAssessmentsByVendorId parameters: - in: path name: vendorId required: true schema: type: string - in: query name: pageSize required: false schema: $ref: '#/components/schemas/PageSize' - in: query name: pageCursor required: false schema: $ref: '#/components/schemas/PageCursor' - description: Filter assessments to any of the given assessment type IDs in: query name: typeIdMatchesAny required: false schema: items: type: string type: array - description: Filter assessments to any of the given statuses in: query name: statusMatchesAny required: false schema: type: array items: $ref: '#/components/schemas/AssessmentStatus' responses: '200': description: Ok content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_VendorAssessment_' examples: Example 1: value: results: data: - id: a2f7e1b9d0c3f4e5a6c7b8d8 vendorId: 6696e9bca247cbdf1c8e5054 status: COMPLETED completedByUserId: 6696ea0595df50d5cd6ec3b7 startDate: '2024-02-01T00:00:00.000Z' dueDate: '2024-03-01T00:00:00.000Z' overrideDueDate: '2024-03-15T00:00:00.000Z' completionDate: '2024-03-10T00:00:00.000Z' createdDate: '2024-01-25T00:00:00.000Z' decision: status: APPROVED lastUpdatedAt: '2024-03-17T00:00:00.000Z' comments: >- No major concerns, limited sharing of data, low security risk. assessmentType: id: 6696ea0595df50d5cd6ec3b8 name: Security description: null owner: id: 6696ea0595df50d5cd6ec3b9 type: USER displayName: Jane Doe email: jane.doe@example.com pageInfo: hasNextPage: false hasPreviousPage: false startCursor: 6696ea0595df50d5cd6ec3b7 endCursor: 6696ece48eb1f98ff3d927c6 security: - bearerAuth: [] components: schemas: PageSize: type: integer format: int32 default: 10 description: >- Controls the maximum number of items returned in one response from the API. minimum: 1 maximum: 100 PageCursor: type: string description: >- A marker or pointer, telling the API where to start fetching items for the subsequent page in a paginated dataset. Note that the requested page will not include the item that corresponds to this cursor but will start from the one immediately after this cursor. AssessmentStatus: description: |- The lifecycle status of an assessment: - NOT_STARTED: The assessment has not yet been started. - IN_PROGRESS: The assessment is underway. - COMPLETED: The assessment has been completed. enum: - NOT_STARTED - IN_PROGRESS - COMPLETED type: string PaginatedResponse_VendorAssessment_: properties: results: properties: data: items: $ref: '#/components/schemas/VendorAssessment' type: array pageInfo: $ref: '#/components/schemas/PageInfo' required: - data - pageInfo type: object required: - results type: object additionalProperties: false VendorAssessment: properties: id: type: string description: Unique identifier for the assessment. vendorId: type: string description: Unique identifier for the vendor. status: $ref: '#/components/schemas/AssessmentStatus' description: The lifecycle status of the assessment. completedByUserId: type: string nullable: true description: The Vanta user ID of the person who completed this assessment. startDate: type: string format: date-time nullable: true description: The timestamp of when the assessment was started. dueDate: type: string format: date-time nullable: true description: The timestamp of when the assessment is due. overrideDueDate: type: string format: date-time nullable: true description: A manual override timestamp of when the assessment is due. completionDate: type: string format: date-time nullable: true description: The timestamp of when the assessment was marked as completed. createdDate: type: string format: date-time description: The timestamp of when the assessment was created. decision: properties: comments: type: string nullable: true description: Comments about the assessment decision. lastUpdatedAt: type: string format: date-time description: The timestamp of when the assessment decision was last set. status: $ref: '#/components/schemas/AssessmentDecision' description: The status of the current decision. required: - comments - lastUpdatedAt - status type: object nullable: true description: >- An object containing information about the decision of the assessment. assessmentType: $ref: '#/components/schemas/AssessmentType' description: The assessment type for this assessment. owner: allOf: - $ref: '#/components/schemas/AssessmentOwner' nullable: true description: The owner of this assessment, if assigned. required: - id - vendorId - status - completedByUserId - startDate - dueDate - overrideDueDate - completionDate - createdDate - decision - assessmentType - owner type: object additionalProperties: false PageInfo: description: Provides information about the pagination of a dataset. properties: endCursor: type: string nullable: true description: >- The cursor that points to the end of the current page, or null if there is no such cursor. hasNextPage: type: boolean description: Indicates if there is another page after the current page. hasPreviousPage: type: boolean description: Indicates if there is a page before the current page. startCursor: type: string nullable: true description: >- The cursor that points to the start of the current page, or null if there is no such cursor. required: - endCursor - hasNextPage - hasPreviousPage - startCursor type: object additionalProperties: false AssessmentDecision: description: >- The current decision made for an assessment: - APPROVED: The assessment has been approved. - NOT_APPROVED: The assessment has been marked not approved. - CONDITIONALLY_APPROVED: The assessment has been conditionally approved. enum: - APPROVED - NOT_APPROVED - CONDITIONALLY_APPROVED type: string AssessmentType: properties: id: type: string description: Unique identifier for the assessment type. name: type: string description: Display name of the assessment type. description: type: string nullable: true description: Description of the assessment type, if set. required: - id - name - description type: object additionalProperties: false AssessmentOwner: properties: id: type: string description: Unique identifier for the owner. type: $ref: '#/components/schemas/AssessmentOwnerType' description: The type of actor that owns this assessment. displayName: type: string nullable: true description: Display name of the owner, if available. email: type: string nullable: true description: Email of the owner. Populated for USER owners, null for TEAM owners. required: - id - type - displayName - email type: object additionalProperties: false AssessmentOwnerType: type: string enum: - USER - TEAM securitySchemes: bearerAuth: type: http scheme: bearer ````