How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

UpGuard vendors API

The vendors API from UpGuard — 32 operation(s) for vendors.

UpGuard vendors API is one of 18 APIs that UpGuard publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Vendors. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 33 operations across 32 paths, and defines 72 schemas. It is described by OpenAPI 2.0, at version 1.13.2.

Requests are made against the base URL https://cyber-risk.upguard.com/api/public.

33 operations 32 paths 72 schemas 24 GET4 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 2.0
API Version
1.13.2
Base URL
https://cyber-risk.upguard.com/api/public
Authentication
API Key
Resource Areas
1

Authentication & Security 1

UpGuard vendors API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (API key in header). By default, every request must be authenticated.

Paths & Operations 33

Across 32 paths, the API surfaces 33 operations — 24 GET, 4 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.

vendors 33
GET
/fourth_party/list
List fourth party vendors
fourth_parties_params 7 params → 200403422429500
GET
/onboarding_request
Get onboarding request details
onboardingRequestGet 1 param → 200403404422429500
GET
/onboarding_request/list
List onboarding requests
onboardingRequestsList 7 params → 200403422429500
GET
/vendor
Get vendor details
vendor 7 params → 200202402404422429500
GET
/vendor/additionalevidence
Retrieve (one or more) vendor additional evidence documents by id
additional_evidence 2 params → 200300403422429500
GET
/vendor/additionalevidence/list
List vendor additional evidence instances
additional_evidences_list 3 params → 200422429500
PUT
/vendor/attributes
Assign or update the attributes for a vendor
vendor_update_attributes 1 param → 204403422429500
GET
/vendor/contact
Get a vendor contact by ID
vendor_contact_get 1 param → 200403422429500
GET
/vendor/contact/list
List vendor contacts
vendor_contact_list 3 params → 200403422429500
GET
/vendor/document
Retrieve (one or more) vendor documents by id
document 2 params → 200300403422429500
GET
/vendor/documents
List vendor documents
documents 3 params → 200422429500
GET
/vendor/domain
Retrieve details for a domain
vendor_domain_details 2 params → 200403422429500
PUT
/vendor/domain/labels
Assign labels to a domain
vendor_domain_update_labels 3 params → 204403422429500
GET
/vendor/domains
List vendor domains
vendor_domains 8 params → 200403422429500
GET
/vendor/ip
Retrieve details for an IP address
vendor_ip_details 2 params → 200403422429500
PUT
/vendor/ip/labels
Assign labels to an IP
vendor_ip_update_labels 3 params → 204403422429500
GET
/vendor/ips
List vendor ips
vendor_ips 6 params → 200403422429500
PUT
/vendor/labels
Assign labels to a vendor
vendor_update_labels 2 params → 204403422429500
POST
/vendor/monitor
Start monitoring a vendor
monitorvendor 5 params → 200202402404422429500
GET
/vendor/questionnaire
Get questionnaire metadata
questionnaireGet 1 param → 200403404422429500
POST
/vendor/questionnaire
Send a security questionnaire to a vendor
sendQuestionnaire 1 param → 200403404422429500
GET
/vendor/questionnaire/answers
Get questionnaire questions and answers
questionnaireAnswers 1 param → 200403404422429500
GET
/vendor/questionnaire/attachment
Retrieve (one or more) vendor questionnaire attachments by id
attachment 2 params → 200300403422429500
GET
/vendor/questionnaire/attachment/list
List vendor questionnaire attachments
questionnaireAttachmentsGet 3 params → 200403422429500
GET
/vendor/questionnaire/comments
Get questionnaire comments
questionnaireComments 1 param → 200403404422429500
GET
/vendor/questionnaire_types
List available vendor questionnaire types
getquestionnairetypes → 200403429500
GET
/vendor/questionnairesdeprecated
List vendor questionnaires
questionnaires 4 params → 200422429500
GET
/vendor/questionnaires/v2
List vendor questionnaires
questionnairesV2 4 params → 200422429500
GET
/vendor/ranges
List vendor ip ranges
vendor_ranges 6 params → 200403422429500
POST
/vendor/relationship_questionnaire
Send a relationship questionnaire about a vendor
sendrelationshipquestionnaire 1 param → 200403404422429500
PUT
/vendor/tier
Assign tier to a vendor
vendor_update_tier 2 params → 204403422429500
POST
/vendor/unmonitor
Stop monitoring a vendor
unmonitorvendor 2 params → 200404422429500
GET
/vendors
List monitored vendors
vendors 5 params → 200422429500

Schemas 72

The contract defines 72 schemas that model the data the API accepts and returns. The most detailed are vendor (27 properties), OnboardingRequestDetail (17 properties), ScoreByEpoch (17 properties), monitoredVendor (15 properties). Each schema is shown below with its type and property counts.

Category
string
Category values cannot be changed after first use, as they're referenced in storage.
QuestionnaireSender
object
QuestionnaireSender represents the sender of a questionnaire
2 properties
GetVendorAttachmentResponsePayload
object
1 property
TextAnswer
object
TextAnswer represents a text answer
1 property
VendorsRisk
object
7 properties
UserMini
object
UserMini represents a minimal user reference in external API responses
2 properties
QuestionnaireRecipient
object
QuestionnaireRecipient represents a recipient of a questionnaire
4 properties
endpointError
object
Error details coming from an endpoint
1 property
MultipleChoiceAnswer
object
MultipleChoiceAnswer represents a multiple choice answer
1 property
OnboardingRequestDetail
object
OnboardingRequestDetail represents the full detail of a single onboarding request
17 properties
CheckResult
object
13 properties
GetFourthPartiesV1RespBody
object
3 properties
fourthParty
object
6 properties
OnboardingVendorInfo
object
OnboardingVendorInfo represents vendor information in the external API
8 properties
VendorQuestionnaireAttachment
object
A vendor questionnaire attachment
4 properties
GetVendorQuestionnairesV2ResponsePayload
object
2 properties
Domain
object
6 properties
PostVendorQuestionnaireBody
object
Must contain exactly one of vendorid or vendorprimaryhostname.
10 properties 5 required
document
object
A vendor document
4 properties
PostVendorRelationshipQuestionnaireBody
object
5 properties
fourthPartyProduct
object
5 properties
CategoryScores
object
A collection of category scores for a vendor
14 properties
GetVendorQuestionnairesV1ResponsePayload
object
3 properties
GetVendorAdditionalEvidenceResponsePayload
object
1 property
questionnaireType
object
Questionnaire Type
2 properties
GetVendorDocumentResponsePayload
object
1 property
ScoreByEpoch
object
17 properties
GetVendorDocumentsResponsePayload
object
3 properties
Question
object
Question represents a flattened question for the external API
12 properties
IP
object
9 properties
LinkedRiskAssessment
object
LinkedRiskAssessment represents a linked risk assessment in the external API
3 properties
RiskCounts
object
The count of risks for this vendor, broken down by severity
4 properties
Property
object
2 properties
OnboardingRequestListItem
object
OnboardingRequestListItem represents a single onboarding request in the list response
14 properties
VendorContact
object
9 properties
DomainScore
object
2 properties
File
object
endpoint300Error
object
Multipart error details coming from an endpoint
1 property
VendorMetadata
object
Various pieces of metadata for the vendor
7 properties
OutcomeSnapshot
object
OutcomeSnapshot represents the outcome of a completed onboarding request
4 properties
GetQuestionnaireAnswersResponsePayload
object
1 property
GetVendorAdditionalEvidencesResponsePayload
object
3 properties
OnboardingRequestsListRespBody
object
OnboardingRequestsListRespBody is the response body for the onboarding requests list endpoint
3 properties
GetRangesV1RespBody
object
3 properties
SingleChoiceAnswer
object
SingleChoiceAnswer represents a single choice answer
2 properties
GetIPsV1RespBody
object
3 properties
ChoiceOption
object
ChoiceOption represents a single option in a choice question
4 properties
GetQuestionnaireResponsePayload
object
13 properties
questionnaire
object
8 properties
QuestionnaireComment
object
QuestionnaireComment represents a comment on a questionnaire
10 properties
shared_questionnaire
object
5 properties
FileUploadAnswer
object
FileUploadAnswer represents a file upload answer
1 property
UpdateVendorAttributesV1RequestBody
object
2 properties 1 required
IPSource
string
VendorsResponsePayloadBody
object
3 properties
GetQuestionnaireCommentsResponsePayload
object
1 property
monitoredVendor
object
A monitored vendor
15 properties
fourthPartyWatchedVendor
object
5 properties
additional_evidences_list
object
A vendor additional evidences list
6 properties
vendor
object
A vendor
27 properties
questionnaireRecipient
object
Model for a questionnaire recipient
4 properties 1 required
questionnaireSent
object
Questionnaire ID
1 property
RiskAnswer
object
RiskAnswer represents a risk answer
2 properties
relationship_questionnaire_sent
object
Relationship Questionnaire ID
1 property
ApiRange
object
9 properties
GetIpDetailsV1RespBody
object
12 properties
Severity
integer
GetDomainsV1RespBody
object
3 properties
CategoryRiskCounts
object
The count of risks, broken down by category, then by severity
14 properties
VendorContactList
object
2 properties
GetVendorQuestionnaireAttachmentsResponsePayload
object
3 properties
GetDomainDetailsV1RespBody
object
7 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

upguard-vendors-api-openapi.yml Raw ↑

Other APIs UpGuard publishes across the network.

UpGuard breaches API
UpGuard bulk API
UpGuard dataleaks API
UpGuard domains API
UpGuard ips API
UpGuard labels API
UpGuard notifications API
UpGuard organisation API
UpGuard reports API
UpGuard risks API
UpGuard subsidiaries API
UpGuard threatmonitoring API
Where this information came from

This is an independent, third-party profile of UpGuard vendors API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.