This API has been deprecated.

Partners and customers using a deprecated API should contact SAP Concur and discuss moving to the latest versions.

Learn more in the API Lifecycle & Deprecation Policy.

Description

Retrieves the list of quick expenses for the supplied user or for the entire company. In order to view the company-wide expense list, the OAuth Consumer must have the Web Services Admin (Professional) or Can Administer (Standard) user role.

NOTE: Documentation for the v3.0 resource is here.

Request

Request parameters

loginID={loginID} The Concur login for the user that owns the quick expenses. Optional.

Example:

https://www.concursolutions.com/api/expense/expensereport/v1.0/quickexpense/?loginID={loginID}

Headers

Authorization header

The authorization header must contain an OAuth token for a valid Concur user.

To view company-wide data, the OAuth consumer must have one of the following user roles in Concur: Company Administrator or Web Services Administrator for Professional, or Can Administer for Standard.

Accept header

  • application/xml
  • application/json

Response

This request will return a QuickExpensesList parent element with a QuickExpense child element for each quick expense.

<QuickExpensesList>
  <QuickExpense>
    <OwnerLoginID></OwnerLoginID>
    <OwnerName></OwnerName>
    <QuickExpenseKey></QuickExpenseKey>
    <ExpenseTypeKey></ExpenseTypeKey>
    <ExpenseTypeName></ExpenseTypeName>
    <TransactionDate></TransactionDate>
    <TransactionAmount></TransactionAmount>
    <CurrencyCode></CurrencyCode>
    <LocationName></LocationName>
    <VendorDescription></VendorDescription>
    <Comment></Comment>
  </QuickExpense>
</QuickExpensesList>

QuickExpense child elements

The QuickExpense child element contains details of the quick expense.

Element Name Required/Optional Data Type Description
OwnerLoginID - - The Concur login ID for the expense owner. Useful for system to system integration when there are expenses for multiple users.
OwnerName - - The first and last name for the expense owner. Useful for system to system integration when there are expenses for multiple users.
QuickExpenseKey - - The unique identifier for the quick expense.
ExpenseTypeKey - - The unique identifier for the expense type associated with the quick expense.
ExpenseTypeName - - The name of the expense type associated with the quick expense.
TransactionDate - - The date the expense was incurred. Format: YYYY-MM-DD
TransactionAmount - - The total amount of the expense in the original currency, with up to three decimal places. Example: 123.654
CurrencyCode - - The 3-letter ISO 4217 currency code for the expense transaction amount. Example: USD.
LocationName - - The name of the location where the expense was incurred.
VendorDescription - - This element contains the descriptive text for the vendor for the expense.
Comment - - The comment for this expense.

Examples

Example 1: XML

Request with LoginID

GET api/expense/expensereport/v1.0/quickexpense/?loginID=cm%40example.com HTTPS/1.1
Host: www.concursolutions.com
Authorization: OAuth {access token}

Response

HTTPS/1.1 200 OK
Content-Type: application/xml
<QuickExpensesList>
  <QuickExpense>
    <OwnerLoginID>cm@example.com</OwnerLoginID>
    <OwnerName>Chris Miller</OwnerName>
    <QuickExpenseKey>1234567890</QuickExpenseKey>
    <ExpenseTypeKey>CARRT</ExpenseTypeKey>
    <ExpenseTypeName>Car Rental</ExpenseTypeName>
    <TransactionDate>2012-07-21</TransactionDate>
    <TransactionAmount>321.45</TransactionAmount>
    <CurrencyCode>USD</CurrencyCode>
    <LocationName>Seattle, Washington</LocationName>
    <VendorDescription>Avis</VendorDescription>
    <Comment>Trip to Seattle</Comment>
  </QuickExpense>
  <QuickExpense>
    <OwnerLoginID>cm@example.com</OwnerLoginID>
    <OwnerName>Chris Miller</OwnerName>
    <QuickExpenseKey>0987654321</QuickExpenseKey>
    <ExpenseTypeKey>MEAL910</ExpenseTypeKey>
    <ExpenseTypeName>Breakfast</ExpenseTypeName>
    <TransactionDate>2012-07-21</TransactionDate>
    <TransactionAmount>14.23</TransactionAmount>
    <CurrencyCode>USD</CurrencyCode>
    <LocationName>Seattle, Washington</LocationName>
    <VendorDescription>Starbucks</VendorDescription>
    <Comment>Trip to Seattle</Comment>
  </QuickExpense>
</QuickExpensesList>

Example 2: JSON

Request

GET api/expense/expensereport/v1.0/quickexpense/?loginID=cm%40example.com HTTPS/1.1
Accept: application/json

Response

[
  {
    "OwnerLoginID": "cm@example.com",
    "OwnerName": "Chris Miller",
    "QuickExpenseKey": "nuIsue2$pASZDo12345678oUuUh9Lb0",
    "ExpenseTypeKey": "CARRT",
    "ExpenseTypeName": "Car Rental",
    "TransactionDate": "2012-07-21",
    "TransactionAmount": 321.45000000,
    "CurrencyCode": "USD",
    "LocationName": "Seattle, Washington",
    "VendorDescription": "Avis",
    "Comment": "Trip to Seattle",
  }
]