The getuserinfo.do call returns information about the specified user.
Before
using this API, Veracode strongly recommends that you read API Usage and Access
Guidelines.
Resource URL
https://analysiscenter.veracode.com/api/3.0/getuserinfo.doPermissions
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 |
---|---|---|
username Required |
String | Required for non-SAML users. Usually the email address of the user. |
custom_id Required |
String | Required for SAML users. The SAML Subject field value from the user account. |
HTTPie Example
Examples use the HTTPie command-line tool. See Using HTTPie with the Python Authentication Library.
http --auth-type=veracode_hmac -o userinfo.xml "https://analysiscenter.veracode.com/api/3.0/getuserinfo.do" "username==tmonarch@example.com"
HTTPie Results
The getuserinfo.do call returns the userinfo XML document, which references the userinfo.xsd schema file. You can use the XSD schema file to validate the XML data. See the userinfo.xsd schema documentation.
<?xml version="1.0" encoding="UTF-8"?> <userinfo xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="https://analysiscenter.veracode.com/schema/userinfo/3.0" xsi:schemaLocation="https://analysiscenter.veracode.com/schema/userinfo/3.0 https://analysiscenter.veracode.com/resource/3.0/userinfo.xsd" userinfo_version="3.0" username="tmonarch@example.com"> <login_account first_name="Ted" last_name="Monarch" login_account_type="user" email_address="tmonarch@example.com" login_enabled="true" requires_token="false" teams="Demo Team" roles="Creator,eLearning,Submitter,Any Scan" is_elearning_manager="false" elearning_manager="No Manager" elearning_track="No Track Assigned" elearning_curriculum="No Curriculum Assigned" keep_elearning_active="false"/> </userinfo>