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

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.

On this page