Vendor IDs and references

/api/2.0/fo/vendor/

[GET]  [POST]

This API lists vendor IDs and names related to vulnerabilities in the KnowledgeBase. This vendor information can be used to define dynamic search lists. All users except Auditors have permission to run this API.

Input Parameters

Parameter

Description

action={value}

(Required) Set to “list_vendors” to list vendor IDs and names. Set to “list_vendor_references” to list vendor references for QIDs.

echo_request={0|1}

(Optional) Specify 1 to view (echo) input parameters in the XML output. By default these are not included.

ids={id1,id2,...}

(Optional for action=list) One or more vendors IDs to list those vendors only.

qids={qid1,qid2,...}

(Optional for action=list_vendor_references) One or more QIDs to list vendors references for those QIDs only.

 

Sample - List vendor IDs and names

API request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: Curl"

"https://qualysapi.qualys.com/api/2.0/fo/vendor/?action=list_vendors&ids=458,1967"

XML output

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE VENDOR_LIST_OUTPUT SYSTEM "https://qualysapi.qualys.com/api/2.0/fo/vendor/vendor_list_output.dtd">

<VENDOR_LIST_OUTPUT>

    <RESPONSE>

        <DATETIME>2018-04-02T09:23:52Z</DATETIME>

        <VENDORS>

            <VENDOR>

                <ID>458</ID>

                <NAME>

                    <![CDATA[3com]]>

                </NAME>

            </VENDOR>

            <VENDOR>

                <ID>1967</ID>

                <NAME>

                    <![CDATA[2glux]]>

                </NAME>

            </VENDOR>

        </VENDORS>

    </RESPONSE>

</VENDOR_LIST_OUTPUT>

DTD for vendor list

<platform API server>/api/2.0/fo/vendor/vendor_list_output.dtd

Sample - List vendor references for QIDs

API request

curl -u "USERNAME:PASSWORD" -H "X-Requested-With: Curl"

"https://qualysapi.qualys.com/api/2.0/fo/vendor/?action=list_vendor_references"

XML output

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE VENDOR_REFERENCE_LIST_OUTPUT SYSTEM "https://qualysapi.qualys.com/api/2.0/fo/vendor/vendor_reference_list_output.dtd">

<VENDOR_REFERENCE_LIST_OUTPUT>

    <RESPONSE>

        <DATETIME>2018-04-02T09:27:34Z</DATETIME>

        <VENDOR_REFERENCES>

            <VENDOR_REFERENCE>

                <QID>195464</QID>

                <REFERENCE_INFO>

                    <REFERENCE>

                        <![CDATA[USN-2186-1]]>

                    </REFERENCE>

                    <URL>

                        <![CDATA[https://lists.ubuntu.com/archives/ubuntu-security-announce/2014-April/002483.html]]>

                    </URL>

                </REFERENCE_INFO>

            </VENDOR_REFERENCE>

            <VENDOR_REFERENCE>

                <QID>115844</QID>

                <REFERENCE_INFO>

                    <REFERENCE>

                        <![CDATA[RHSA-2008-0508]]>

                    </REFERENCE>

                    <URL>

                        <![CDATA[http://rhn.redhat.com/errata/RHSA-2008-0508.html]]>

                    </URL>

                </REFERENCE_INFO>

                <REFERENCE_INFO>

                    <REFERENCE>

                        <![CDATA[RHSA-2008-0519]]>

                    </REFERENCE>

                    <URL>

                        <![CDATA[http://rhn.redhat.com/errata/RHSA-2008-0519.html]]>

                    </URL>

                </REFERENCE_INFO>

            </VENDOR_REFERENCE>

       </VENDOR_REFERENCES>

...

    </RESPONSE>

</VENDOR_REFERENCE_LIST_OUTPUT>

DTD for vendor reference list

<platform API server>/api/2.0/fo/vendor/vendor_reference_list_output.dtd