Travel Request v4 - Agency Proposal Resources

Send proposals within a Request

Scopes

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

HTTP Request

URI Template
POST {datacenter}/travelrequest/v4/requests/{requestUuid}/agencyproposals

Parameters

Name Type Format Description
requestUuid string - Required The unique identifier of the Request.
userId string - The unique identifier of the travel agent assigned to the travel agency linked to the proposal feature.
Required when connecting with a Company token, if empty a 400 missingRequiredParam error code will be displayed.

Headers

Payload

Agency proposals

HTTP Response

HTTP Status Codes

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

Payload

Agency proposals - The created proposal(s).

Example

HTTP Request

POST https://us.api.concursolutions.com/travelrequest/v4/requests/{requestUuid}/agencyproposals
Accept: application/json
Authorization: Bearer {token}
Concur-CorrelationId: 5512c7be-3fab-4d65-ae69-8a74a04a0c7f

HTTP Response

200 OK
{
  "agencyProposalEntries": [
    {
      "agencyProposalSegments": [
        {
          "booked": true,
          "confirmationNumber": "RecordLocator246",
          "endDate": "2021-05-02",
          "endTime": "21:18",
          "pnr": "OYY5T",
          "policyCompliantLevel": 50,
          "proposalSegmentType": "AIR",
          "startDate": "2021-05-02",
          "startTime": "20:06",
          "vendorName": "AIR FRANCE",
          "timeZone": "UTC+12:00",
          "classOfService": "Economy",
          "duration": 60,
          "flightNumber": "AF030",
          "endLocation": {
            "iataCode": "CDG"
          },
          "startLocation": {
            "iataCode": "OSL"
          }
        },
        {
           "booked" : true,
          "confirmationNumber": "RecordLocator246",
          "endDate": "2021-05-01",
          "endTime": "08:30",
          "pnr": "OYY5T",
          "policyCompliantLevel": 50,
          "proposalSegmentType": "AIR",
          "startDate": "2021-05-01",
          "startTime": "07:24",
          "vendorName": "AIR FRANCE",
          "timeZone": "UTC+12:00",
          "classOfService": "Economy",
          "duration": 60,
          "flightNumber": "AF029",
          "startLocation": {
            "iataCode": "CDG"
          },
          "endLocation": {
            "iataCode": "OSL"
          }
        }
              ],
      "transactionAmount": {
        "currency": "EUR",
        "value": 300.16
      },
      "transactionDate": "2021-03-29T03:04:05.678Z"
    },
    
    {
      "agencyProposalSegments": [
           {
          "booked": true,
          "comments": "Staying at Liberty Hotel",
          "confirmationNumber": "RecordLocator123",
          "endDate": "2021-05-02",
          "endTime": "10:00",
          "pnr": "OCC5T",
          "policyCompliantLevel": 50,
          "proposalSegmentType": "HOTEL",
          "startDate": "2021-05-01",
          "startTime": "18:00",
          "vendorName": "ACCOR",
          "timeZone": "UTC+12:00",
          "location": {
            "countryCode": "NO",
            "city": "Oslo"
          },
          "name": "Liberty Hotel",
          "roomDescription": "Single",
          "providerPhone": "+3260000000",
          "locationDetail": "No smoker",
          "address": "Fjord Place"
        }
      ],
      "transactionAmount": {
        "currency": "EUR",
        "value": 146.00
      },
      "transactionDate": "2021-03-29T03:04:05.678Z"
    }
  ],
  "agencyProposalType": "API",
  "approvalLimitDate": "2021-04-24T03:04:05.678Z",
  "booked": true,
  "comments": "",
  "itineraryLocator": "AR15U",
  "policyCompliant": true,
  "proposalOrder": 1,
  "proposalBatchSize": 2,
  "providerMessageId": "XKRDFGE",
  "status": "PROPOSAL",
  "totalPostedAmount": {
    "currency": "EUR",
    "value": 446.16
  }
}
{
  "agencyProposalEntries": [
    {
      "agencyProposalSegments": [
        {
          "booked": true,
          "confirmationNumber": "RecordLocator246",
          "endDate": "2021-05-02",
          "endTime": "20:18",
          "pnr": "OYY5T",
          "policyCompliantLevel": 50,
          "proposalSegmentType": "AIR",
          "startDate": "2021-05-02",
          "startTime": "19:06",
          "vendorName": "AIR FRANCE",
          "timeZone": "UTC+12:00",
          "classOfService": "Economy",
          "duration": 60,
          "flightNumber": "AF031",
          "endLocation": {
            "iataCode": "CDG"
          },
          "startLocation": {
            "iataCode": "OSL"
          }
        },
        {
           "booked" : true,
          "confirmationNumber": "RecordLocator246",
          "endDate": "2021-05-01",
          "endTime": "09:30",
          "pnr": "OYY5T",
          "policyCompliantLevel": 50,
          "proposalSegmentType": "AIR",
          "startDate": "2021-05-01",
          "startTime": "08:24",
          "vendorName": "AIR FRANCE",
          "timeZone": "UTC+12:00",
          "classOfService": "Economy",
          "duration": 60,
          "flightNumber": "AF030",
          "startLocation": {
            "iataCode": "CDG"
          },
          "endLocation": {
            "iataCode": "OSL"
          }
        }
              ],
      "transactionAmount": {
        "currency": "EUR",
        "value": 350.17
      },
      "transactionDate": "2021-03-29T03:04:05.678Z"
    },
    
    {
      "agencyProposalSegments": [
           {
          "booked": false,
          "comments": "Staying at Opera Hotel",
          "confirmationNumber": "RecordLocator123",
          "endDate": "2021-05-02",
          "endTime": "10:00",
          "pnr": "OCC5T",
          "policyCompliantLevel": 50,
          "proposalSegmentType": "HOTEL",
          "startDate": "2021-05-01",
          "startTime": "18:00",
          "vendorName": "ACCOR",
          "timeZone": "UTC+12:00",
          "location": {
            "countryCode": "NO",
            "city": "Oslo"
          },
          "name": "Opera Hotel",
          "roomDescription": "Double",
          "providerPhone": "+3260000000",
          "locationDetail": "No smoker",
          "address": "Ulriken Place"
        }
      ],
      "transactionAmount": {
        "currency": "EUR",
        "value": 200.00
      },
      "transactionDate": "2021-03-29T03:04:05.678Z"
    }
  ],
  "agencyProposalType": "API",
  "approvalLimitDate": "2021-04-26T03:04:05.678Z",
  "booked": true,
  "comments": "",
  "itineraryLocator": "AR15U",
  "policyCompliant": true,
  "proposalOrder": 2,
  "proposalBatchSize": 2,
  "providerMessageId": "XKRDFGE",
  "status": "PROPOSAL",
  "totalPostedAmount": {
    "currency": "EUR",
    "value": 550.17
  }
}

Get the list of agency proposals

Scopes

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

HTTP Request

URI Template
GET {datacenter}/travelrequest/v4/requests/{requestUuid}/agencyproposals

Parameters

Name Type Format Description
requestUuid string - Required The unique identifier of the Request.

Headers

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

Agency proposals

Example

HTTP Request

GET https://us.api.concursolutions.com/travelrequest/v4/requests/{requestUuid}/agencyproposals
Accept: application/json
Authorization: Bearer {token}
Concur-CorrelationId: 5512c7be-3fab-4d65-ae69-8a74a04a0c7f

HTTP Response

200 OK
[
    {
        "proposalUuid": "c76eb8f5-10fa-4840-95e0-3c730b0cad46",
        "agencyProposalEntries": [
            {
                "proposalEntryUuid": "38607d43-477b-4544-9cc3-3bcc224db838",
                "matchingExpense": {},
                "transactionDate": "2021-03-29T03:04:06.000Z",
                "comments": "Staying at Opera Hotel",
                "transactionAmount": {
                    "value": 200.00000000,
                    "currency": "EUR"
                },
                "agencyProposalSegments": [
                    {
                        "address": "Ulriken Place",
                        "booked": false,
                        "comments": "Staying at Opera Hotel",
                        "confirmationNumber": "RecordLocator123",
                        "endDate": "2021-05-02",
                        "endTime": "10:00",
                        "location": {
                            "countryCode": "NO",
                            "city": "Oslo"
                        },
                        "locationDetail": "No smoker",
                        "matchingSegmentLeg": {},
                        "name": "Opera Hotel",
                        "pnr": "OCC5T",
                        "policyCompliant": false,
                        "policyCompliantLevel": 50,
                        "proposalSegmentType": "HOTEL",
                        "proposalSegmentUuid": "ea706941-462b-4d63-a28f-9ac560adcb5e",
                        "providerPhone": "+3260000000",
                        "roomDescription": "Double",
                        "segmentTypeCode": "HOTEL",
                        "startDate": "2021-05-01",
                        "startTime": "18:00",
                        "timeZone": "UTC+12:00",
                        "vendorName": "ACCOR"
                    }
                ]
            },
            {
                "proposalEntryUuid": "654fb089-0fed-4891-ac2f-da2f480dfab4",
                "matchingExpense": {},
                "transactionDate": "2021-03-29T03:04:06.000Z",
                "comments": "",
                "transactionAmount": {
                    "value": 350.17000000,
                    "currency": "EUR"
                },
                "agencyProposalSegments": [
                    {
                        "booked": true,
                        "classOfService": "Economy",
                        "confirmationNumber": "RecordLocator246",
                        "duration": 60,
                        "endDate": "2021-05-02",
                        "endLocation": {
                            "iataCode": "CDG"
                        },
                        "endTime": "20:18",
                        "flightNumber": "AF031",
                        "matchingSegmentLeg": {},
                        "pnr": "OYY5T",
                        "policyCompliant": false,
                        "policyCompliantLevel": 50,
                        "proposalSegmentType": "AIR",
                        "proposalSegmentUuid": "e43b521a-b1b1-48a5-b368-74d36d3fc56e",
                        "segmentTypeCode": "AIRFR",
                        "startDate": "2021-05-02",
                        "startLocation": {
                            "iataCode": "OSL"
                        },
                        "startTime": "19:06",
                        "timeZone": "UTC+12:00",
                        "vendorName": "AIR FRANCE"
                    },
                    {
                        "booked": true,
                        "classOfService": "Economy",
                        "confirmationNumber": "RecordLocator246",
                        "duration": 60,
                        "endDate": "2021-05-01",
                        "endLocation": {
                            "iataCode": "OSL"
                        },
                        "endTime": "09:30",
                        "flightNumber": "AF030",
                        "matchingSegmentLeg": {},
                        "pnr": "OYY5T",
                        "policyCompliant": false,
                        "policyCompliantLevel": 50,
                        "proposalSegmentType": "AIR",
                        "proposalSegmentUuid": "f9c55ba6-bdcf-4e65-b189-40f343076784",
                        "segmentTypeCode": "AIRFR",
                        "startDate": "2021-05-01",
                        "startLocation": {
                            "iataCode": "CDG"
                        },
                        "startTime": "08:24",
                        "timeZone": "UTC+12:00",
                        "vendorName": "AIR FRANCE"
                    }
                ]
            }
        ],
        "agencyProposalType": "API",
        "approvalLimitDate": "2021-04-26T03:04:06.000Z",
        "booked": true,
        "comments": "",
        "importDate": "2021-03-29T09:44:36.000Z",
        "itineraryLocator": "AR15U",
        "policyCompliant": true,
        "proposal": true,
        "proposalBatchSize": 2,
        "proposalOrder": 2,
        "providerMessageId": "XKRDFGE",
        "selected": false,
        "status": "PROPOSAL",
        "totalPostedAmount": {
            "value": 550.17000000,
            "currency": "EUR"
        }
    },
    {
        "proposalUuid": "d6de71be-3716-48cb-b133-a82e03e25bfe",
        "agencyProposalEntries": [
            {
                "proposalEntryUuid": "99a44f02-b1c3-4712-af72-77cabc6f725d",
                "matchingExpense": {
                    "id": "1ECBCB87CE27FE4AB9B5D76E20E05B98"
                },
                "transactionDate": "2021-03-29T03:04:06.000Z",
                "comments": "",
                "transactionAmount": {
                    "value": 300.16000000,
                    "currency": "EUR"
                },
                "agencyProposalSegments": [
                    {
                        "booked": true,
                        "classOfService": "Economy",
                        "confirmationNumber": "RecordLocator246",
                        "duration": 60,
                        "endDate": "2021-05-02",
                        "endLocation": {
                            "iataCode": "CDG"
                        },
                        "endTime": "21:18",
                        "flightNumber": "AF030",
                        "matchingSegmentLeg": {
                            "id": "25C97F6CD6AD9F4AB5E80D6F61730D2D"
                        },
                        "pnr": "OYY5T",
                        "policyCompliant": false,
                        "policyCompliantLevel": 50,
                        "proposalSegmentType": "AIR",
                        "proposalSegmentUuid": "7835f703-2f6b-4b71-96ef-0445355f24f8",
                        "segmentTypeCode": "AIRFR",
                        "startDate": "2021-05-02",
                        "startLocation": {
                            "iataCode": "OSL"
                        },
                        "startTime": "20:06",
                        "timeZone": "UTC+12:00",
                        "vendorName": "AIR FRANCE"
                    },
                    {
                        "booked": true,
                        "classOfService": "Economy",
                        "confirmationNumber": "RecordLocator246",
                        "duration": 60,
                        "endDate": "2021-05-01",
                        "endLocation": {
                            "iataCode": "OSL"
                        },
                        "endTime": "08:30",
                        "flightNumber": "AF029",
                        "matchingSegmentLeg": {
                            "id": "51B98284E6232A40A600E9E92710CADF"
                        },
                        "pnr": "OYY5T",
                        "policyCompliant": false,
                        "policyCompliantLevel": 50,
                        "proposalSegmentType": "AIR",
                        "proposalSegmentUuid": "9e363bdc-0ef4-4332-b5ad-98ab5b759d8f",
                        "segmentTypeCode": "AIRFR",
                        "startDate": "2021-05-01",
                        "startLocation": {
                            "iataCode": "CDG"
                        },
                        "startTime": "07:24",
                        "timeZone": "UTC+12:00",
                        "vendorName": "AIR FRANCE"
                    }
                ]
            },
            {
                "proposalEntryUuid": "b4b50e4d-4082-43ee-8a08-ccc6996fcfd3",
                "matchingExpense": {
                    "id": "CA964E3216D64746A4CFF3EFD49410C6"
                },
                "transactionDate": "2021-03-29T03:04:06.000Z",
                "comments": "Staying at Liberty Hotel",
                "transactionAmount": {
                    "value": 146.00000000,
                    "currency": "EUR"
                },
                "agencyProposalSegments": [
                    {
                        "address": "Fjord Place",
                        "booked": true,
                        "comments": "Staying at Liberty Hotel",
                        "confirmationNumber": "RecordLocator123",
                        "endDate": "2021-05-02",
                        "endTime": "10:00",
                        "location": {
                            "countryCode": "NO",
                            "city": "Oslo"
                        },
                        "locationDetail": "No smoker",
                        "matchingSegmentLeg": {
                            "id": "8D364364F706994994BA226B3356D9FE"
                        },
                        "name": "Liberty Hotel",
                        "pnr": "OCC5T",
                        "policyCompliant": false,
                        "policyCompliantLevel": 50,
                        "proposalSegmentType": "HOTEL",
                        "proposalSegmentUuid": "72ad0da9-ebe6-459b-94e0-4db1cafe173b",
                        "providerPhone": "+3260000000",
                        "roomDescription": "Single",
                        "segmentTypeCode": "HOTEL",
                        "startDate": "2021-05-01",
                        "startTime": "18:00",
                        "timeZone": "UTC+12:00",
                        "vendorName": "ACCOR"
                    }
                ]
            }
        ],
        "agencyProposalType": "API",
        "approvalLimitDate": "2021-04-24T03:04:06.000Z",
        "booked": true,
        "comments": "",
        "importDate": "2021-03-29T09:44:34.000Z",
        "itineraryLocator": "AR15U",
        "policyCompliant": true,
        "proposal": true,
        "proposalBatchSize": 2,
        "proposalOrder": 1,
        "providerMessageId": "XKRDFGE",
        "selected": true,
        "status": "PROPOSAL",
        "totalPostedAmount": {
            "value": 446.16000000,
            "currency": "EUR"
        }
    }
]

On this page