getteaminfo.do

Veracode APIs

The getteaminfo.do call returns information about a specific team.

Before using this API, Veracode strongly recommends that you read API Usage and Access Guidelines. Ensure you access the APIs with the domain for your region.

REST API Equivalent

The REST API equivalent of this call is a GET to /api/authn/v2/teams/{teamId} using the Identity API. Veracode strongly recommends that you use the REST API for this action. For new integrations, always use the REST APIs.

Resource URL

https://analysiscenter.veracode.com/api/3.0/getteaminfo.do

Permissions

An API service account requires the Admin API role to use this call. A user account requires the Administrator role to use this call.

Parameters

Name Type Description
team_id

Required

Integer Team ID.
include_users String Specify Yes to view the members of the team. Default is No.
include_applications String Specify Yes to view applications assigned to the team. Default is No.

HTTPie Example

Examples use the HTTPie command-line tool. See Using HTTPie with the Python Authentication Library.

http --auth-type=veracode_hmac -o teaminfo.xml "https://analysiscenter.veracode.com/api/3.0/getteaminfo.do" "team_id==144659" "include_users==yes" "include_applications==yes"

HTTPie Results

The getteaminfo.do call returns the teaminfo XML document, which references the teaminfo.xsd schema file. You can use the XSD schema file to validate the XML data.
<?xml version="1.0" encoding="UTF-8"?>

<teaminfo xmlns:xsi="http&#x3a;&#x2f;&#x2f;www.w3.org&#x2f;2001&#x2f;XMLSchema-instance" 
      xmlns="https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;schema&#x2f;teaminfo&#x2f;3.0" 
      xsi:schemaLocation="https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;schema&#x2f;teaminfo&#x2f;3.0 
      https&#x3a;&#x2f;&#x2f;analysiscenter.veracode.com&#x2f;resource&#x2f;3.0&#x2f;teaminfo.xsd" 
      teaminfo_version="3.1" team_name="Demo Team" can_view_shared_types="false" business_unit="<business unit>">
   <user username="sviceroy&#x26;&#x23;x40&#x3b;example.com" first_name="Saiya" last_name="Viceroy" 
      email_address="sviceroy&#x40;example.com"/>
   <user username="aswallowtail&#x26;&#x23;x40&#x3b;example.com" first_name="Anna" last_name="Swallowtail" 
      email_address="aswallowtail&#x40;example.com"/>
   <user username="tmonarch&#x26;&#x23;x40&#x3b;example.com" first_name="Ted" last_name="Monarch" 
      email_address="tmonarch&#x40;example.com"/>
   <user username="lpieris&#x26;&#x23;x40&#x3b;example.com" first_name="Li" last_name="Pieris" 
      email_address="lpieris&#x40;example.com"/>
   <application app_id="<app id>" app_name="<app name>" assessment_type="SDLC" account_id="<account id>" 
      business_unit="Not Specified"/>
   <application app_id="<app id>" app_name="<app name>" assessment_type="SDLC" account_id="<account id>" 
      business_unit="Not Specified"/>
</teaminfo>