Request Associations v4
The Report Request Associations v4 API can be used to retrieve the requests associated with a specific report.
Limitations
This API is only available to partners who have been granted access by SAP Concur. Access to this documentation does not provide access to the API.
Products and Editions
- Concur Expense Professional Edition
- Concur Expense Standard Edition
Scope Usage
Name | Description | Endpoint |
---|---|---|
expense.report.read |
Get information about request associations. | GET |
expense.report.readwrite |
Read and write request associations. | GET |
Dependencies
SAP Concur clients must purchase Concur Expense in order to use this API. User based API requires the use of the Identity v4 API. Please contact your SAP Concur representative for more information.
Access Token Usage
This API supports both company level and user level access tokens.
Retrieves Associated Requests on a Specific Report ID
Retrieves the requests that are associated with a specific report ID.
Scopes
expense.report.read
- Refer to Scope Usage for full details.expense.report.readwrite
- Refer to Scope Usage for full details.
URI
/expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/requestassociations
Parameters
Name | Type | Format | Description |
---|---|---|---|
userID |
string |
- | Required The unique identifier of the SAP Concur user. Please use Identity v4 API to retrieve the userID . |
contextType |
string |
- | Required The access level of the user, which determines the form fields they can view/modify. Supported values: TRAVELER ,MANAGER , PROCESSOR ,PROXY |
reportId |
string |
- | Required The unique identifier of the report that is being read. |
Payloads
- Request: None
- Response: Report Request Associations Response
Examples
Requests
curl -X 'GET' \
'https://us.api.concursolutions.com/expensereports/v4/users/f0257b7a-3f13-4b74-bb9f-66c9020cfb29/context/TRAVELER/reports/28BA437223EE41A49F7B/requestassociations' \
--header 'Authorization: Bearer {access_token}' \
--header 'Content-Type: application/json'
Response
{
"requests": [
{
"id": "6A51F1B24A419543A647DDF523F94C3F"
}
]
}
Request
Name | Type | Format | Description |
---|---|---|---|
id |
string |
- | Required The unique identifier of the request associated with a report. |
Error Message
Name | Type | Format | Description |
---|---|---|---|
customResponseData |
object |
- | The custom parameters related to error. |
errorId |
string |
- | The unique identifier of the error associated with the response. |
errorMessage |
string |
- | Required The detailed error message. |
httpStatus |
string |
- | Required The HTTP response code and phrase for the response. |
path |
string |
- | Required The URI of the attempted request. |
timestamp |
string |
date-time |
Required The time when the error was captured. |
validationErrors |
ValidationError |
- | The validation error messages. |
Validation Error
Name | Type | Format | Description |
---|---|---|---|
id |
string |
- | The ID of the validation error. |
message |
string |
- | The detailed message of the validation error. |
source |
string |
- | The type of validation which failed. |