Agentivity API

<back to all web services

BookingDetailsByRef

The following routes are available for this service:
GET/BookingDetails
BookingDetailsByRef Parameters:
NameParameterData TypeRequiredDescription
AgentivityRefqueryintegerNoAgentivity Booking Reference
LoadOptionsquerystringNoOptions to retrieve booking details (valid values are: Passengers, Itinerary, DiEntries, Phones, Notepads, VendorRemarks, Tickets, Versions, VendorLocators, CustomFields, Emails, AccountValue, EventDetails or EmailTrails). The option All can be used to get entire booking data.
RecordLocatorquerystringNoRecord locator
PNRCreationDatequerystringNoDate in format YYYYMMDD
RequestConsultantIDquerystringNoRequest Consultant ID (sign on)
CompanyLevelRequestBase Parameters:
NameParameterData TypeRequiredDescription
OwningCompanyCodequerystringNoComma Delimited List of Owning Company Codes
UserNamequerystringNoUserName in form of an email address
PagingMetadata Parameters:
NameParameterData TypeRequiredDescription
OffsetquerystringNoStarting Record
LimitquerystringNoNumber of records to return (PageSize)
TotalRecordsquerystringNoTotal Number of Records in a Full Reponse (if no paging)
ResponseRecordsquerystringNoTotal Number of Records in this Reponse (on this page)
CollectionResponse<TItem> Parameters:
NameParameterData TypeRequiredDescription
ResponseMetadataformResponseMetadataNo
ResponseReportformList<TItem>No
ResponseErrorformAgentivityErrorNo
ResponseMetadata Parameters:
NameParameterData TypeRequiredDescription
SuccessformboolNo
HasCacheformboolNo
HasPagingformboolNo
CacheMetadataformCacheMetadataNo
PagingMetadataformPagingMetadataNo
CacheMetadata Parameters:
NameParameterData TypeRequiredDescription
CachedAtformDateTimeNo
CacheExpiresAtformDateTimeNo
IsFromCacheformboolNo
AgentivityError Parameters:
NameParameterData TypeRequiredDescription
ErrorCodeformstringNo
MessageformstringNo
StatusCodeformstringNo
VerboseMessageformstringNo
BookingDetails Parameters:
NameParameterData TypeRequiredDescription
RecordLocatorformstringNo
PNRCreationDateformstringNo
CreationDateformDateTime?No
PNRTicketedformstringNo
AccountformstringNo
OwningConsultantIDformstringNo
OwningConsultantformstringNo
CrsDescriptionformstringNo
LastActionConsultantIDformstringNo
LastActionAgencyLocationIDformstringNo
OwningAgencyLocationIDformstringNo
CreatingAgencyIataformstringNo
CompanyIDformint?No
PassengersformList<PassengerDetails>No
PhonesformList<BookingPhone>No
NotepadsformList<BookingNotepad>No
VendorRemarksformList<VendorRemark>No
DiEntriesformList<DiEntry>No
TicketsformList<BookingTicket>No
VersionsformList<BookingVersion>No
VendorLocatorsformList<BookingVendorLocator>No
CustomFieldsformList<CustomFieldValue>No
EmailsformList<BookingEmail>No
EventDetailsformList<BookingEventDetail>No
AccountLocationsformList<BookingAccountLocation>No
EmailTrailsformList<BookingEmailTrail>No
AgentivityWarningsformList<BookingDetailsWarning>No
AirlineTicketingDuesformList<BookingDetailsAirTicketingDue>No
CTCEformstringNo
CTCMformstringNo
CarbonTonnageformdouble?No
CarbonEmissionsformList<CarbonEmission>No
OwningCompanyCodeformstringNo
AgentivityRefformintNo
ItineraryformItinerarySegmentsCollectionNo
ItineraryFormattedformstringNo
PassengerDetails Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
FirstNameformstringNo
LastNameformstringNo
FrequentFlyersformList<FrequentFlyerDetails>No
SequenceNbrformintNo
LastNameElementformintNo
IsVipformboolNo
FrequentFlyerDetails Parameters:
NameParameterData TypeRequiredDescription
VendorformstringNo
NumberformstringNo
FullNumberformstringNo
BookingPhone Parameters:
NameParameterData TypeRequiredDescription
PhoneTypeformstringNo
CityformstringNo
NumberformstringNo
SequenceNbrformintNo
BookingNotepad Parameters:
NameParameterData TypeRequiredDescription
RemarkformstringNo
CreatedDateformDateTime?No
CreatedTimeformstringNo
QualifierformstringNo
SequenceNbrformintNo
VendorRemark Parameters:
NameParameterData TypeRequiredDescription
VendorRemarkIDformintNo
VendorRemarkBase Parameters:
NameParameterData TypeRequiredDescription
TravelOrderIdentifierformint?No
RmkNumformint?No
DateStampformDateTime?No
TimeStampformstringNo
RemarkTypeformstringNo
VendorTypeformstringNo
VendorformstringNo
RemarkformstringNo
DiEntry Parameters:
NameParameterData TypeRequiredDescription
SequenceNbrformintNo
KeywordformstringNo
RemarkformstringNo
BookingTicket Parameters:
NameParameterData TypeRequiredDescription
SegmentNbrformintNo
TicketNumberformstringNo
TicketTypeformstringNo
TicketDetailsAvailableformboolNo
BookingVersion Parameters:
NameParameterData TypeRequiredDescription
AgentivityRefformint?No
DataBaseTimeStampformDateTime?No
EventTypeformstringNo
PnrTicketedformstringNo
LastActionAgentIdformstringNo
AirSegsformintNo
AirPSegsformintNo
HtlSegsformintNo
HtlPSegsformintNo
CarSegsformintNo
CarPSegsformintNo
TrnPSegsformintNo
OwningAgencyLocationIDformstringNo
BookingVendorLocator Parameters:
NameParameterData TypeRequiredDescription
AirSegmentNbrformint?No
CarrierCodeformstringNo
VendorLocatorformstringNo
CustomFieldValue Parameters:
NameParameterData TypeRequiredDescription
PNRPropertiesCustomFieldIDformstringNo
RecordLocatorformstringNo
PNRCreationDateformDateTimeNo
FieldNameformstringNo
FieldValueformstringNo
CustomFieldIDformint?No
CreationDateTimeformDateTime?No
ElementNumberformint?No
GDSformstringNo
BookingEmail Parameters:
NameParameterData TypeRequiredDescription
SequenceNbrformintNo
EmailTypeformstringNo
EmailformstringNo
BookingEventDetail Parameters:
NameParameterData TypeRequiredDescription
ItineraryEventTypeDetailIDformintNo
AgentivityRefformintNo
EventTypeDetailformstringNo
OldDataformstringNo
NewDataformstringNo
DateTimeStampformDateTime?No
EventTypeDetailIDformint?No
BookingAccountLocation Parameters:
NameParameterData TypeRequiredDescription
PrimaryAccountLocationformstringNo
SecondaryAccountLocationformstringNo
ValidformboolNo
ExactMatchformboolNo
GDSformstringNo
BookingEmailTrail Parameters:
NameParameterData TypeRequiredDescription
RecipientEmailformstringNo
DeliveryDetailsformstringNo
MailSentDateTimeformDateTime?No
RecipientLastActivityEventformstringNo
EmailIdformint?No
UserIdformint?No
SentResponseMessageformstringNo
SentResponseErrorCodeformint?No
DeliveredBookingIDformintNo
BookingDetailsWarning Parameters:
NameParameterData TypeRequiredDescription
MessageformstringNo
VendorformstringNo
WarningDateTimeformDateTime?No
OriginalRemarkformstringNo
ClearedDateTimeformDateTime?No
ClearedByConsultantIDformstringNo
PropertiesListformList<BookingWarningProperty>No
BookingWarningProperty Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
ValueformstringNo
BookingDetailsAirTicketingDue Parameters:
NameParameterData TypeRequiredDescription
AirlineformstringNo
DueDateformDateTime?No
DueTimeformstringNo
CarbonEmission Parameters:
NameParameterData TypeRequiredDescription
Valueformdouble?No
UnitformMeasurementUnitNo
ProviderformAssessmentProviderNo
CalculationDateTimeformDateTime?No
CalculationDetailsformCarbonCalculationDetailsNo
MeasurementUnit Parameters:
NameParameterData TypeRequiredDescription
IdformshortNo
SymbolformstringNo
NameformstringNo
AssessmentProvider Parameters:
NameParameterData TypeRequiredDescription
IdformshortNo
NameformstringNo
DescriptionformstringNo
LogoPathformstringNo
CarbonCalculationDetails Parameters:
NameParameterData TypeRequiredDescription
IdformshortNo
NameformstringNo
ItinerarySegment Parameters:
NameParameterData TypeRequiredDescription
SegmentTypeformstringNo
SegmentNbrformintNo
BoardPointformstringNo
OffPointformstringNo
OperatorCodeformstringNo
OperatorServiceformstringNo
SegmentStatusformstringNo
DepartureTimeFormattedformstringNo
ArrivalTimeFormattedformstringNo
ChangeOfDayFormattedformstringNo
ServiceCodeformstringNo
StartDateformstringNo
EndDateformstringNo
TicketNumberformstringNo
VendorLocatorsquerystringNoComma separated list of vendor locators
EquipmentCodeformstringNo
EquipmentformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET //BookingDetails HTTP/1.1 
Host: api.agentivity.com 
Accept: application/xml
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<AgentivityResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="schemas.agentivity.com/types">
  <ResponseMetadata>
    <Success>false</Success>
    <HasCache>false</HasCache>
    <HasPaging>false</HasPaging>
    <CacheMetadata>
      <IsFromCache>false</IsFromCache>
      <CachedAt>0001-01-01T00:00:00</CachedAt>
      <CacheExpiresAt>0001-01-01T00:00:00</CacheExpiresAt>
    </CacheMetadata>
    <PagingMetadata>
      <Limit>String</Limit>
      <Offset>String</Offset>
      <ResponseRecords>0</ResponseRecords>
      <TotalRecords>0</TotalRecords>
    </PagingMetadata>
  </ResponseMetadata>
  <ResponseReport>
    <BookingDetails>
      <AgentivityRef>0</AgentivityRef>
      <RecordLocator>String</RecordLocator>
      <PNRCreationDate>String</PNRCreationDate>
      <CreationDate>0001-01-01T00:00:00</CreationDate>
      <PNRTicketed>String</PNRTicketed>
      <Account>String</Account>
      <OwningConsultantID>String</OwningConsultantID>
      <OwningConsultant>String</OwningConsultant>
      <CrsDescription>String</CrsDescription>
      <LastActionConsultantID>String</LastActionConsultantID>
      <LastActionAgencyLocationID>String</LastActionAgencyLocationID>
      <OwningAgencyLocationID>String</OwningAgencyLocationID>
      <CreatingAgencyIata>String</CreatingAgencyIata>
      <CompanyID>0</CompanyID>
      <Passengers>
        <Passenger>
          <Id>0</Id>
          <FirstName>String</FirstName>
          <LastName>String</LastName>
          <FrequentFlyers>
            <FrequentFlyer>
              <Vendor>String</Vendor>
              <Number>String</Number>
              <FullNumber>String</FullNumber>
            </FrequentFlyer>
          </FrequentFlyers>
          <SequenceNbr>0</SequenceNbr>
          <LastNameElement>0</LastNameElement>
          <IsVip>false</IsVip>
        </Passenger>
      </Passengers>
      <Phones>
        <Phone>
          <PhoneType>String</PhoneType>
          <City>String</City>
          <Number>String</Number>
          <SequenceNbr>0</SequenceNbr>
        </Phone>
      </Phones>
      <Notepads>
        <Notepad>
          <Remark>String</Remark>
          <CreatedDate>0001-01-01T00:00:00</CreatedDate>
          <CreatedTime>String</CreatedTime>
          <Qualifier>String</Qualifier>
          <SequenceNbr>0</SequenceNbr>
        </Notepad>
      </Notepads>
      <VendorRemarks>
        <VendorRemark>
          <DateStamp>0001-01-01T00:00:00</DateStamp>
          <Remark>String</Remark>
          <RemarkType>String</RemarkType>
          <RmkNum>0</RmkNum>
          <TimeStamp>String</TimeStamp>
          <TravelOrderIdentifier>0</TravelOrderIdentifier>
          <Vendor>String</Vendor>
          <VendorType>String</VendorType>
          <VendorRemarkID>0</VendorRemarkID>
        </VendorRemark>
      </VendorRemarks>
      <DiEntries>
        <DIEntry>
          <SequenceNbr>0</SequenceNbr>
          <Keyword>String</Keyword>
          <Remark>String</Remark>
        </DIEntry>
      </DiEntries>
      <Tickets>
        <Ticket>
          <SegmentNbr>0</SegmentNbr>
          <TicketNumber>String</TicketNumber>
          <TicketType>String</TicketType>
          <TicketDetailsAvailable>false</TicketDetailsAvailable>
        </Ticket>
      </Tickets>
      <Versions>
        <Version>
          <AgentivityRef>0</AgentivityRef>
          <DataBaseTimeStamp>0001-01-01T00:00:00</DataBaseTimeStamp>
          <EventType>String</EventType>
          <PnrTicketed>String</PnrTicketed>
          <LastActionAgentId>String</LastActionAgentId>
          <AirSegs>0</AirSegs>
          <AirPSegs>0</AirPSegs>
          <HtlSegs>0</HtlSegs>
          <HtlPSegs>0</HtlPSegs>
          <CarSegs>0</CarSegs>
          <CarPSegs>0</CarPSegs>
          <TrnPSegs>0</TrnPSegs>
          <OwningAgencyLocationID>String</OwningAgencyLocationID>
        </Version>
      </Versions>
      <VendorLocators>
        <VendorLocator>
          <AirSegmentNbr>0</AirSegmentNbr>
          <CarrierCode>String</CarrierCode>
          <VendorLocator>String</VendorLocator>
        </VendorLocator>
      </VendorLocators>
      <CustomFields>
        <CustomFieldValue>
          <PNRPropertiesCustomFieldID>String</PNRPropertiesCustomFieldID>
          <RecordLocator>String</RecordLocator>
          <PNRCreationDate>0001-01-01T00:00:00</PNRCreationDate>
          <FieldName>String</FieldName>
          <FieldValue>String</FieldValue>
          <CustomFieldID>0</CustomFieldID>
          <CreationDateTime>0001-01-01T00:00:00</CreationDateTime>
          <ElementNumber>0</ElementNumber>
          <GDS>String</GDS>
        </CustomFieldValue>
      </CustomFields>
      <Emails>
        <Email>
          <SequenceNbr>0</SequenceNbr>
          <EmailType>String</EmailType>
          <Email>String</Email>
        </Email>
      </Emails>
      <EventDetails>
        <EventDetail>
          <ItineraryEventTypeDetailID>0</ItineraryEventTypeDetailID>
          <AgentivityRef>0</AgentivityRef>
          <EventTypeDetail>String</EventTypeDetail>
          <OldData>String</OldData>
          <NewData>String</NewData>
          <DateTimeStamp>0001-01-01T00:00:00</DateTimeStamp>
          <EventTypeDetailID>0</EventTypeDetailID>
        </EventDetail>
      </EventDetails>
      <AccountLocations>
        <AccountLocation>
          <PrimaryAccountLocation>String</PrimaryAccountLocation>
          <SecondaryAccountLocation>String</SecondaryAccountLocation>
          <Valid>false</Valid>
          <ExactMatch>false</ExactMatch>
          <GDS>String</GDS>
        </AccountLocation>
      </AccountLocations>
      <EmailTrails>
        <BookingEmailTrail>
          <RecipientEmail>String</RecipientEmail>
          <DeliveryDetails>String</DeliveryDetails>
          <MailSentDateTime>0001-01-01T00:00:00</MailSentDateTime>
          <RecipientLastActivityEvent>String</RecipientLastActivityEvent>
          <EmailId>0</EmailId>
          <UserId>0</UserId>
          <SentResponseMessage>String</SentResponseMessage>
          <SentResponseErrorCode>0</SentResponseErrorCode>
          <DeliveredBookingID>0</DeliveredBookingID>
        </BookingEmailTrail>
      </EmailTrails>
      <AgentivityWarnings>
        <Warning>
          <Message>String</Message>
          <Vendor>String</Vendor>
          <WarningDateTime>0001-01-01T00:00:00</WarningDateTime>
          <OriginalRemark>String</OriginalRemark>
          <ClearedDateTime>0001-01-01T00:00:00</ClearedDateTime>
          <ClearedByConsultantID>String</ClearedByConsultantID>
          <PropertiesList>
            <Property>
              <Name>String</Name>
              <Value>String</Value>
            </Property>
          </PropertiesList>
        </Warning>
      </AgentivityWarnings>
      <AirlineTicketingDues>
        <TicketingDue>
          <Airline>String</Airline>
          <DueDate>0001-01-01T00:00:00</DueDate>
          <DueTime>String</DueTime>
        </TicketingDue>
      </AirlineTicketingDues>
      <CTCE>String</CTCE>
      <CTCM>String</CTCM>
      <CarbonTonnage>0</CarbonTonnage>
      <CarbonEmissions>
        <CarbonEmission>
          <Value>0</Value>
          <Unit>
            <Id>0</Id>
            <Symbol>String</Symbol>
            <Name>String</Name>
          </Unit>
          <Provider>
            <Id>0</Id>
            <Name>String</Name>
            <Description>String</Description>
            <LogoPath>String</LogoPath>
          </Provider>
          <CalculationDateTime>0001-01-01T00:00:00</CalculationDateTime>
          <CalculationDetails>
            <Id>0</Id>
            <Name>String</Name>
          </CalculationDetails>
        </CarbonEmission>
      </CarbonEmissions>
      <OwningCompanyCode>String</OwningCompanyCode>
      <Itinerary>
        <ItinerarySegment>
          <ArrivalTimeFormatted>String</ArrivalTimeFormatted>
          <BoardPoint>String</BoardPoint>
          <ChangeOfDayFormatted>String</ChangeOfDayFormatted>
          <DepartureTimeFormatted>String</DepartureTimeFormatted>
          <EndDate>String</EndDate>
          <Equipment>String</Equipment>
          <EquipmentCode>String</EquipmentCode>
          <OffPoint>String</OffPoint>
          <OperatorCode>String</OperatorCode>
          <OperatorService>String</OperatorService>
          <SegmentNbr>0</SegmentNbr>
          <SegmentStatus>String</SegmentStatus>
          <SegmentType>String</SegmentType>
          <ServiceCode>String</ServiceCode>
          <StartDate>String</StartDate>
          <TicketNumber>String</TicketNumber>
          <VendorLocators>String</VendorLocators>
        </ItinerarySegment>
      </Itinerary>
      <ItineraryFormatted>String</ItineraryFormatted>
    </BookingDetails>
  </ResponseReport>
  <ResponseError>
    <ErrorCode>String</ErrorCode>
    <Message>String</Message>
    <StatusCode>String</StatusCode>
    <VerboseMessage>String</VerboseMessage>
  </ResponseError>
</AgentivityResponse>