getbuildlist.do

APIs

The getbuildlist call produces a list of the policy or sandbox scans of the application that are currently in progress or already complete.

Before using this API, Veracode strongly recommends that you read API Usage and Access Guidelines.

Resource URL

https://analysiscenter.veracode.com/api/5.0/getbuildlist.do

Parameters

app_id Integer. Required.
sandbox_id Integer. Optional.

cURL Example

curl --compressed -u
        <VeracodeUsername>:<VeracodePassword>
        https://analysiscenter.veracode.com/api/5.0/getbuildlist.do -F "app_id=10886" -F
        "sandbox_id=10701"

cURL Results

The getbuildlist.do call returns the buildlist XML document, which references the buildlist.xsd. Additional buildlist.xsd schema documentation is available. Use the XSD file to validate the XML data.

Java Examples

The following example uses the Veracode API ID and key credentials:

java -jar vosp-api-wrappers-java-<version #>.jar -vid <VeracodeApiId> -vkey
        <VeracodeApiKey> -action getbuildlist –appid <app id>

The following example uses the Veracode username and password:

java -jar
        vosp-api-wrappers-java-<version #>.jar -vuser <VeracodeUsername> -vpassword
        <VeracodePassword> -action getbuildlist –appid <app id>

Java Results

The getbuildlist.do call returns the buildlist XML document, which references the buildlist.xsd. The following is an example of the returned XML:

<buildlist xmlns="https://analysiscenter.veracode.com/schema/2.0/buildlist" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
account_id="12345" app_id=<app id> app_name="MyApp" buildlist_version="1.3" xsi:schemaLocation="https://analysiscenter.veracode.com/schema/2.0/buildlist 
https://analysiscenter.veracode.com/resource/2.0/buildlist.xsd">
   <build build_id="1112223" policy_updated_date="2018-02-06T10:48:32-05:00" version="Scan#1"/>
   <build build_id="3344455" policy_updated_date="2018-02-11T21:00:14-05:00" version="Scan#2"/>
   <build build_id="6677888" policy_updated_date="2018-02-13T21:54:22-05:00" version="Scan#3"/>
</buildlist>