title | layout |
---|---|
Request Associations v4 |
reference |
The Report Request Associations v4 API can be used to retrieve the requests associated with a specific report.
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.
- Concur Expense Professional Edition
- Concur Expense Standard Edition
Name | Description | Endpoint |
---|---|---|
expense.report.read |
Get information about request associations. | GET |
expense.report.readwrite |
Read and write request associations. | GET |
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.
This API supports both company level and user level access tokens.
Retrieves the requests that are associated with a specific report ID.
expense.report.read
- Refer to Scope Usage for full details.expense.report.readwrite
- Refer to Scope Usage for full details.
/expensereports/v4/users/{userId}/context/{contextType}/reports/{reportId}/requestassociations
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. |
- Request: None
- Response: Report Request Associations Response
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'
{
"requests": [
{
"id": "6A51F1B24A419543A647DDF523F94C3F"
}
]
}
Name | Type | Format | Description |
---|---|---|---|
id |
string |
- | Required The unique identifier of the request associated with a report. |
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. |
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. |