Enables integration with Concur Expense for creating, retrieving, and managing expense reports, entries, and related data.
Provides access to travel booking data, profiles, and itinerary information within Concur Travel.
Allows integration with Concur Invoice for managing purchase requests, invoices, and payment requests.
Enables management of travel requests and approvals within the Concur system.
Manages user accounts and profiles, including creating, updating, and retrieving user information. Supports provisioning across Identity, Spend, and Travel services with bulk op...
Allows for the submission and management of digital receipts within Concur Expense.
Exposes budget and fiscal year data, enabling partners and clients to read and manage fiscal years, budget categories, budget items, budget tracking fields, and budget adjustmen...
Provides an automated integration pathway for certified partner financial networks, issuing banks, and fin-tech partners to submit credit card account and transaction data to Co...
Enables the creation of expenses with minimal information such as date, amount, and expense type, with or without a receipt image. Supports attaching receipt files including PNG...
Allows users to create custom exchange rates for a company, supporting bulk uploads of exchange rate data for specified currency pairs and effective dates with a maximum of 100 ...
Allows an external system to interact with financial documents generated from SAP Concur for financial posting into an ERP, providing an automated solution to request approved e...
Creates, updates, and reads user core identity profiles following the SCIM 2.0 standard. Enables looking up SAP Concur UUIDs for accessing other v4 APIs for individual users.
Implements the Publish/Subscribe pattern using principles of Event Driven Architecture, notifying clients and partners when specific business events occur such as expense report...
Allows clients to add interactions with outside systems to their users SAP Concur experience through application connectors, supporting attendee data fetch, list item fetch, eve...
Provides a method for custom hotel source suppliers to provide hotel inventory, rates, and booking related functionality to SAP Concur Online Booking Tool, supporting search, ra...
Enables travel users to access ground transportation inventory from service providers, supporting search, reservation, cancellation, and update operations for ground transportat...
Facilitates ingestion and retrieval of receipt documents for use within Concur Expense, enabling users to create and retrieve simple receipts by uploading documents with associa...
Provides an automated solution for retrieving, adding, updating, and deleting list items within SAP Concur, supporting hierarchical list structures with parent-child relationshi...
Enables viewing configured lists within SAP Concur products and creating new lists, supporting shared lists across Expense, Invoice, and Request applications with managed list c...
Enables retrieval of travel profile information for specified users and lists of travel profile summaries, available to developers, travel suppliers, and travel management compa...
Allows extraction of travel allowance information from the SAP Concur platform, providing the ability to read travel allowance itinerary data, calculation results, and configura...
Enables users to create, view, and issue cash advances within Concur Expense. Supports single cash advance creation, retrieval, and issuance operations for both Professional and...
Gives SAP Concur clients the ability to leverage external data to create and update approved purchase orders. Enables direct connections to manage purchase orders and resolve ma...
Enables SAP Concur clients to leverage external data to create purchase requests for pre-authorization of purchase orders. Organizations can establish direct connections to auto...
Provides processes for managing vendor collections used in invoicing, including adding new vendors, updating, retrieving, and deleting information for existing vendors. Supports...
Enables retrieval and updating of invoices for tax calculation purposes, allowing external tax systems to fetch invoices requiring tax assessment and submit calculated tax amoun...
Manages transmission of compliance documents between SAP Concur and validating vendors, enabling vendors to exchange compliance documents, validate them against relevant authori...
Enables clients to manage receipt images attached to expense reports and images associated with invoices. Users can retrieve existing images by report ID, image ID, or invoice I...
Exposes receipt requests to inform E-Receipt partners which E-Receipts to send to SAP Concur and for which user. Partners receive paginated responses and can filter results usin...
Retrieves details about locations used by Concur that are valid at a user's company. Supports filtering by name, city, country, and other geographic parameters, and returns loca...
Provides access to the configured attendee types within SAP Concur, allowing retrieval and management of attendee type resources used for categorizing attendees in expense reports.
opencollection: 1.0.0
info:
name: SAP Concur Expense Report API
version: 4.0.0
request:
auth:
type: bearer
token: '{{bearerToken}}'
items:
- info:
name: Reports
type: folder
items:
- info:
name: Sap Concur Create a New Expense Report
type: http
http:
method: POST
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for write operations. TRAVELER for the report owner or PROXY for a delegate acting
on behalf of the owner.
body:
type: json
data: '{}'
docs: Creates a new expense report for the specified user. The report is created in an unsubmitted state and can be populated
with expenses before submission through the workflow.
- info:
name: Sap Concur Retrieve an Expense Report by Id
type: http
http:
method: GET
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for the request. TRAVELER for the report owner, MANAGER for an approver, PROXY for
a delegate.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
docs: Returns the full details of a specific expense report including header information, amounts, approval status, and
custom data.
- info:
name: Sap Concur Update an Unsubmitted Expense Report
type: http
http:
method: PATCH
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for write operations. TRAVELER for the report owner or PROXY for a delegate acting
on behalf of the owner.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
body:
type: json
data: '{}'
docs: Partially updates an unsubmitted expense report using JSON Merge Patch (RFC 7386). Only fields included in the request
body are updated; omitted fields remain unchanged.
- info:
name: Sap Concur Update a Submitted Expense Report
type: http
http:
method: PATCH
url: https://us.api.concursolutions.com/expensereports/v4/reports/:reportId
params:
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
body:
type: json
data: '{}'
auth:
type: bearer
token: '{{bearerToken}}'
docs: Partially updates a submitted expense report. Only Company JWT authentication is permitted. Updatable fields are
limited to businessPurpose, comment, customData, name, and isPaperReceiptsReceived.
- info:
name: Sap Concur Delete an Expense Report
type: http
http:
method: DELETE
url: https://us.api.concursolutions.com/expensereports/v4/reports/:reportId
params:
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
docs: Permanently deletes an expense report and all associated expenses, allocations, and comments. Only unsubmitted reports
can be deleted.
- info:
name: Sap Concur Retrieve Report Form Field Configuration
type: http
http:
method: GET
url: https://us.api.concursolutions.com/expensereports/v4/reports/:reportId/formFields
params:
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
- name: policyId
value: '500123'
type: query
description: Policy identifier to determine applicable form fields
docs: Returns the configured form fields for a specific expense report, including field metadata, validation rules, and
display properties.
- info:
name: Sap Concur Retrieve Reports Pending Approval
type: http
http:
method: GET
url: https://us.api.concursolutions.com/expensereports/v4/users/:userId/context/:contextType/reportsToApprove
params:
- name: userId
value: '500123'
type: path
description: The unique identifier of the approving manager
- name: contextType
value: MANAGER
type: path
description: Must be MANAGER for this endpoint
- name: sort
value: example_value
type: query
description: Field to sort results by
- name: order
value: ASC
type: query
description: Sort order
- name: includeDelegateApprovals
value: 'true'
type: query
description: Whether to include reports delegated for approval
docs: Returns a list of expense reports awaiting approval for the specified manager, including delegate approvals if requested.
- info:
name: Expenses
type: folder
items:
- info:
name: Sap Concur Retrieve All Expenses on a Report
type: http
http:
method: GET
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/expenses
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for the request. TRAVELER for the report owner, MANAGER for an approver, PROXY for
a delegate.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
docs: Returns a summary list of all expense entries (line items) associated with the specified expense report.
- info:
name: Sap Concur Retrieve a Single Expense by Id
type: http
http:
method: GET
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/expenses/:expenseId
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for the request. TRAVELER for the report owner, MANAGER for an approver, PROXY for
a delegate.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
- name: expenseId
value: ''
type: path
description: The unique identifier of the expense entry
docs: Returns the full details of a specific expense entry including transaction amounts, vendor information, location,
payment type, allocation state, tax summary, mileage, and travel data.
- info:
name: Sap Concur Retrieve Itemizations for an Expense
type: http
http:
method: GET
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/expenses/:expenseId/itemizations
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for the request. TRAVELER for the report owner, MANAGER for an approver, PROXY for
a delegate.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
- name: expenseId
value: ''
type: path
description: The unique identifier of the expense entry
docs: Returns the itemized breakdown of a parent expense entry, such as individual charges on a hotel folio or conference
registration.
- info:
name: Sap Concur Update an Expense on a Submitted Report
type: http
http:
method: PATCH
url: https://us.api.concursolutions.com/expensereports/v4/reports/:reportId/expenses/:expenseId
params:
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
- name: expenseId
value: ''
type: path
description: The unique identifier of the expense entry
body:
type: json
data: '{}'
auth:
type: bearer
token: '{{bearerToken}}'
docs: Partially updates an expense on a submitted report. Only Company JWT authentication is permitted. Updatable fields
are limited to businessPurpose, customData, expenseSource, isExpenseRejected, and isPaperReceiptReceived.
- info:
name: Sap Concur Delete an Expense From a Report
type: http
http:
method: DELETE
url: https://us.api.concursolutions.com/expensereports/v4/reports/:reportId/expenses/:expenseId
params:
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
- name: expenseId
value: ''
type: path
description: The unique identifier of the expense entry
docs: Permanently removes an expense entry and its associated allocations and itemizations from a report.
- info:
name: Sap Concur Retrieve Expense Form Field Configuration
type: http
http:
method: GET
url: https://us.api.concursolutions.com/expensereports/v4/reports/:reportId/expenses/:expenseId/formFields
params:
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
- name: expenseId
value: ''
type: path
description: The unique identifier of the expense entry
- name: expenseTypeId
value: '500123'
type: query
description: Expense type identifier to filter applicable fields
docs: Returns the configured form fields for a specific expense entry, including field metadata, validation rules, and
display properties.
- info:
name: Allocations
type: folder
items:
- info:
name: Sap Concur Retrieve Allocations for an Expense
type: http
http:
method: GET
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/expenses/:expenseId/allocations
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for the request. TRAVELER for the report owner, MANAGER for an approver, PROXY for
a delegate.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
- name: expenseId
value: ''
type: path
description: The unique identifier of the expense entry
docs: Returns all allocations associated with a specific expense entry, showing how the expense amount is distributed
across cost centers, departments, or accounts.
- info:
name: Sap Concur Retrieve a Single Allocation by Id
type: http
http:
method: GET
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/allocations/:allocationId
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for the request. TRAVELER for the report owner, MANAGER for an approver, PROXY for
a delegate.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
- name: allocationId
value: ''
type: path
description: The unique identifier of the allocation
docs: Returns the full details of a specific allocation including account codes, amounts, percentage, and custom data
fields.
- info:
name: Sap Concur Update an Allocation
type: http
http:
method: PATCH
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/allocations/:allocationId
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for write operations. TRAVELER for the report owner or PROXY for a delegate acting
on behalf of the owner.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
- name: allocationId
value: ''
type: path
description: The unique identifier of the allocation
body:
type: json
data: '{}'
docs: Partially updates an allocation using JSON Merge Patch (RFC 7386). Typically used to update custom data fields on
allocations. The request body includes the allocation update and the list of expense IDs to which the update applies.
- info:
name: Comments
type: folder
items:
- info:
name: Sap Concur Retrieve Report-level Comments
type: http
http:
method: GET
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/comments
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for the request. TRAVELER for the report owner, MANAGER for an approver, PROXY for
a delegate.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
- name: includeAllComments
value: 'true'
type: query
description: Whether to return comments from all report levels
docs: Returns all comments associated with the expense report header.
- info:
name: Sap Concur Create a Report-level Comment
type: http
http:
method: POST
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/comments
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for the request. TRAVELER for the report owner, MANAGER for an approver, PROXY for
a delegate.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
body:
type: json
data: '{}'
docs: Adds a new comment to the expense report header.
- info:
name: Sap Concur Update the Latest Report-level Comment
type: http
http:
method: PUT
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/comments
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for the request. TRAVELER for the report owner, MANAGER for an approver, PROXY for
a delegate.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
body:
type: json
data: '{}'
docs: Replaces the content of the most recent comment on the report header. Only the latest comment by the authenticated
user can be updated.
- info:
name: Sap Concur Delete the Latest Report-level Comment
type: http
http:
method: DELETE
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/comments
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for the request. TRAVELER for the report owner, MANAGER for an approver, PROXY for
a delegate.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
docs: Removes the most recent comment from the expense report header. Only the latest comment by the authenticated user
can be deleted.
- info:
name: Sap Concur Retrieve Expense-level Comments
type: http
http:
method: GET
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/expenses/:expenseId/comments
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for the request. TRAVELER for the report owner, MANAGER for an approver, PROXY for
a delegate.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
- name: expenseId
value: ''
type: path
description: The unique identifier of the expense entry
docs: Returns all comments associated with a specific expense entry.
- info:
name: Sap Concur Create an Expense-level Comment
type: http
http:
method: POST
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/expenses/:expenseId/comments
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for the request. TRAVELER for the report owner, MANAGER for an approver, PROXY for
a delegate.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
- name: expenseId
value: ''
type: path
description: The unique identifier of the expense entry
body:
type: json
data: '{}'
docs: Adds a new comment to a specific expense entry.
- info:
name: Workflows
type: folder
items:
- info:
name: Sap Concur Submit an Expense Report for Approval
type: http
http:
method: PATCH
url: https://us.api.concursolutions.com/expensereports/v4/users/:userId/reports/:reportId/submit
params:
- name: userId
value: '500123'
type: path
description: The unique identifier of the report owner
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
docs: Submits an unsubmitted expense report into the approval workflow. The report must have at least one expense entry
and pass all configured validation rules.
- info:
name: Sap Concur Approve an Expense Report
type: http
http:
method: PATCH
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/approve
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: MANAGER
type: path
description: Must be MANAGER for approval actions
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
body:
type: json
data: '{}'
docs: Approves an expense report in the current workflow step. The authenticated user must be an assigned approver. Individual
expenses can be rejected within the approval by specifying expenseRejectedComment.
- info:
name: Sap Concur Send Back an Expense Report to the Submitter
type: http
http:
method: PATCH
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/sendBack
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: MANAGER
type: path
description: Must be MANAGER for send-back actions
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
body:
type: json
data: '{}'
docs: Returns a submitted expense report to the employee for corrections. A comment explaining the reason is required.
- info:
name: Sap Concur Recall a Submitted Expense Report
type: http
http:
method: PATCH
url: https://us.api.concursolutions.com/expensereports/v4/users/:userID/context/:contextType/reports/:reportId/recall
params:
- name: userID
value: ''
type: path
description: The unique identifier (UUID) of the SAP Concur user. Obtain via the Identity v4 API.
- name: contextType
value: ''
type: path
description: The access context for write operations. TRAVELER for the report owner or PROXY for a delegate acting
on behalf of the owner.
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
body:
type: json
data: '{}'
docs: Recalls a previously submitted expense report back to unsubmitted status, removing it from the approval workflow.
Only the report owner or a proxy can recall a report.
- info:
name: Sap Concur Retrieve Cost Objects for an Approver
type: http
http:
method: GET
url: https://us.api.concursolutions.com/expensereports/v4/users/:userId/reports/:reportId/costObjectsForApprover
params:
- name: userId
value: '500123'
type: path
description: The unique identifier of the approving manager
- name: reportId
value: ''
type: path
description: The unique identifier of the expense report
docs: Returns the cost objects (cost centers, departments, projects) associated with expenses on a report that are relevant
to the specified approver.
bundled: true
