The Quick Expense API can be used to create an expense with basic information such as date, amount, and expense type, with or without a receipt image. This expense can be added to an expense report within Concur Expense, allowing the user to provide additional details such as attendees, itemizations, etc.

Prior Versions

  • Quick Expense v1 (Deprecated) documentation is available here

Retrieve Quick Expenses

Request

URI

Template
GET https://www.concursolutions.com/api/v3.0/expense/quickexpenses?{key}={value}
Parameters
Name Type Format Description
offset string query The start of the page offset.
limit Int32 query The number of records to return (default 25).
user string query Optional.The login ID of the user. The user must have the Web Services Admin (Professional) or Can Administer (Standard) user role to use this parameter.

Payload

None

Response

Payload

Items

Example

Request

GET https://www.concursolutions.com/api/v3.0/expense/quickexpenses?limit=15&user=ALL

Response

{
  "Items": [
    {
      "ExpenseTypeCode": "DINNR",
      "PaymentTypeCode": "CPAID",
      "TransactionDate": "2015-03-17T00:00:00",
      "TransactionAmount": 17.01,
      "CurrencyCode": "USD",
      "VendorDescription": "I Love Sushi",
      "Comment": "Does this default to Cash?",
      "OwnerLoginID": "user@concurconnect2.com",
      "OwnerName": "user",
      "ExpenseTypeName": "Dinner",
      "LocationName": "",
      "ReceiptImageID": null,
      "ID": "gWr6YqsUJgM3BFgTKATDDdg2d",
      "URI": "https://www.concursolutions.com/api/v3.0/expense/quickexpenses/gWr6YqsUJgM3BFgTKATDDdg2d"
    }
  ]
}

Retrieve Quick Expense by ID

Request

URI

Template
GET https://www.concursolutions.com/api/v3.0/expense/quickexpenses/{id}
Parameters
Name Type Format Description
id string path Required The ID of the quick expense.
user string query Optional. The login ID of the user. The user must have the Web Services Admin (Professional) or Can Administer (Standard) user role to use this parameter.

Payload

None

Response

Payload

Item

Example

Request

GET https://www.concursolutions.com/api/v3.0/expense/quickexpenses/gWr7QiDXTuWSO8bsFmK87bnP%24sC8fZmg

Response

{
  "ExpenseTypeCode": "DINNR",
  "PaymentTypeCode": "CPAID",
  "TransactionDate": "2015-03-17T00:00:00",
  "TransactionAmount": 17.01,
  "CurrencyCode": "USD",
  "VendorDescription": "I Love Sushi",
  "Comment": "Does this default to Cash?",
  "OwnerLoginID": "jimadmin@concurconnect2.com",
  "OwnerName": "Jim Admin",
  "ExpenseTypeName": "Dinner",
  "LocationName": "",
  "ReceiptImageID": null,
  "ID": "gWr7QiDXTuWSO8bsFmK87bnP$sC8fZmg",
  "URI": "https://www.concursolutions.com/api/v3.0/expense/quickexpenses/gWr7QiDXTuWSO8bsFmK87bnP$sC8fZmg"
}

Create a Quick Expense

Request

URI

Template
POST https://www.concursolutions.com/api/v3.0/expense/quickexpenses
Parameters

None

Payload

Item noting data in the POST by the client code does not include ID or URI.

Response

Payload

Item noting only the ID and URI key value pairs are in the response.

Example

Request

POST https://www.concursolutions.com/api/v3.0/expense/quickexpenses

Response

{
  "ID": "gWr7QiDXTuWSO8bsFmK87bnP$sC8fZmg",
  "URI": "https://www.concursolutions.com/api/v3.0/expense/quickexpenses/gWr7QiDXTuWSO8bsFmK87bnP$sC8fZmg"
}

Update a Quick Expense

Request

URI

Template
PUT https://www.concursolutions.com/api/v3.0/expense/quickexpenses/{id}
Parameters
Name Type Format Description
id string path Required The ID of the quick expense

Payload

Item - Partial or complete QuickExpense resource to update.

Response

Example

Request

PUT https://www.concursolutions.com/api/v3.0/expense/quickexpenses/gWr7QiDXTuWSO8bsFmK87bnP%24sC8fZmg

Delete a Quick Expense

Request

URI

Template
DELETE https://www.concursolutions.com/api/v3.0/expense/quickexpenses/{id}?user={loginId}
Parameters
Name Type Format Description
id string path Required The ID of the quick expense to be deleted
user string query Optional.The login ID of the user. The user must have the Web Services Admin (Professional) or Can Administer (Standard) user role to use this parameter.

Payload

None

Response

Example

Request

DELETE https://www.concursolutions.com/api/v3.0/expense/quickexpenses/gWr7QiDXTuWSO8bsFmK87bnP%24sC8fZmg

Schema

Items

Name Type Format Description
Items Array Item The result collection.
NextPage string - The URI of the next page of results, if any.

Item

Name Type Format Description
Comment string - A comment that describes the expense. Max Length: 2000
CurrencyCode string - The 3-letter ISO 4217 currency code for the expense transaction amount. Example: USD
ExpenseTypeCode string - The code for the expense type in the company’s expense management system. Currently supports Concur Expense codes. The Expense Type Code is returned in the ExpKey element of the Get Expense Group Configuration function response.
ExpenseTypeName string - The name of the expense type associated with the quick expense.
LocationName string - The name of the location where the expense was incurred.
OwnerLoginID string - The SAP Concur login ID for the expense owner. Useful for system to system integration when there are expenses for multiple users.
OwnerName string - The first and last name for the expense owner. Useful for system to system integration when there are expenses for multiple users.
PaymentTypeCode string - This element specifies the method of payment for the expense. Format: CASHX = Cash, CPAID = Company Paid, or PENDC = Pending Card Transaction (default)
ReceiptImageID string - The ID of the receipt image associated with this quick expense, if any.
TransactionAmount Decimal - The total amount of the expense in the original currency, with up to three decimal places. Example: 123.654
TransactionDate DateTime - The date the expense was incurred. Format: YYYY-MM-DD
VendorDescription string - The descriptive text for the vendor for the quick expense. This often matches the Merchant Name found in a credit card transaction. Max Length: 64
URI string - The URI to the resource. Generated by the service (not the client code).
ID string - The unique identifier of the resource. Generated by the service (not the client code).