Travel Request v4 - Allocation Resources

Manage allocations attached to a Request.

Get the Content of an Existing Allocation

Scopes

travelrequest.write - Refer to Scope Usage for full details.

HTTP Request

URI Template
GET {datacenter}/travelrequest/v4/requests/{requestUuid}/allocations/{allocationUuid}

Parameters

Name Type Format Description
requestUuid string path Required The unique identifier of the Request.
allocationUuid string path RequiredThe unique identifier of the Allocation.
userId string query The unique identifier of the user getting the content of the Request. If empty when using a Company token the default system user will be assumed to perform the action.

Headers

concur-correlationid is a specific custom header used for technical support in the form of a RFC 4122 A Universally Unique Identifier (UUID) URN Namespace.

Payload

None.

HTTP Response

HTTP Status Codes

To learn more about response HTTP status codes for this API see Travel Request v4 - HTTP Status Codes.

Payload

Allocation

Example

HTTP Request

GET https://us2.api.concursolutions.com/travelrequest/v4/requests/224F3CDCC2Q5244A37C72FA5770C6F2/allocations/933E4E76DB29634682ED94F0BAEEDDD5
Accept: application/json
Authorization: Bearer {token}
concur-correlationId: 5512c7be-3fab-4d65-ae69-8a74a04a0c7f

HTTP Response

200 OK

[
{
  "allocationAmount": {
    "value": 245,
    "currency": "USD"
  },
  "approvedAmount": {
    "value": 350,
    "currency": "USD"
  },
  "allocationId": "933E4E76DB29634682ED94F0BAEEDDD5",
  "custom2": {
    "value": "test123",
    "isValid": true
  },
  "expenseId": "11299B37F3593B48ACEA94E465F181B1",
  "percentage": 70,
  "percentEdited": false,
  "systemAllocation": false
}
]

Update the Content of an Existing Allocation

Scopes

travelrequest.write - Refer to Scope Usage for full details.

HTTP Request

URI Template
PUT {datacenter}/travelrequest/v4/requests/{requestUuid}/allocations/{allocationUuid}

Parameters

Name Type Format Description
requestUuid string path Required The unique identifier of the Request.
allocationUuid string path RequiredThe unique identifier of the Allocation.
userId string query The unique identifier of the user getting the content of the Request. If empty when using a Company token the default system user will be assumed to perform the action.

Headers

concur-correlationid is a specific custom header used for technical support in the form of a RFC 4122 A Universally Unique Identifier (UUID) URN Namespace.

Payload

Allocation

HTTP Response

HTTP Status Codes

To learn more about response HTTP status codes for this API see Travel Request v4 - HTTP Status Codes.

Payload

Allocation

Example

HTTP Request

PUT https://us2.api.concursolutions.com/travelrequest/v4/requests/224F3CDCC2Q5244A37C72FA5770C6F2/allocations/933E4E76DB29634682ED94F0BAEEDDD5
Accept: application/json
Authorization: Bearer {token}
concur-correlationId: 5512c7be-3fab-4d65-ae69-8a74a04a0c7f

{
  "custom2": {
    "value": "test123"
  },
  "percentage": 70
}

HTTP Response

200 OK

[
{
  "allocationId": "933E4E76DB29634682ED94F0BAEEDDD5",
  "custom2": {
    "value": "test123",
    "isValid": true
  },
  "expenseId": "11299B37F3593B48ACEA94E465F181B1",
  "percentEdited": false,
  "systemAllocation": false,
  "percentage": 70,
  "percentEdited": false,
  "systemAllocation": false
}
]

On this page