Agentivity API

<back to all web services

FindBookings

The following routes are available for this service:
GET/FindBookings
Imports System
Imports System.IO
Imports System.Collections
Imports System.Collections.Generic
Imports System.Runtime.Serialization
Imports ServiceStack
Imports ServiceStack.DataAnnotations
Imports AgentivityAPI.ServiceModel.Types
Imports AgentivityAPI.ServiceModel.Base
Imports AgentivityAPI.ServiceModel

Namespace Global

    Namespace AgentivityAPI.ServiceModel

        <DataContract(Name:="AgentivityResponse", Namespace:="schemas.agentivity.com/types")>
        Public Partial Class ItemResponse(Of TItem, TReport)
            <DataMember(Order:=1)>
            Public Overridable Property ResponseMetadata As ResponseMetadata

            <DataMember(Order:=2, EmitDefaultValue:=false)>
            Public Overridable Property ResponseReport As TReport

            <DataMember(Order:=3, EmitDefaultValue:=false)>
            Public Overridable Property ResponseError As AgentivityError
        End Class

        <DataContract(Namespace:="schemas.agentivity.com/types")>
        Public Partial Class Report(Of TItemResponse, TItem)
            <DataMember(Order:=1, EmitDefaultValue:=false)>
            Public Overridable Property Item As TItem
        End Class
    End Namespace

    Namespace AgentivityAPI.ServiceModel.Base

        <DataContract(Namespace:="schemas.agentivity.com/types")>
        Public Partial Class CompanyLevelRequestBase
            Inherits PagingMetadata
            Implements IMemberUsername
            Implements IMemberOwningCompanyCode
            '''<Summary>
            '''Comma Delimited List of Owning Company Codes
            '''</Summary>
            <DataMember>
            Public Overridable Property OwningCompanyCode As String() Implements IMemberOwningCompanyCode.OwningCompanyCode

            '''<Summary>
            '''UserName in form of an email address
            '''</Summary>
            <DataMember>
            Public Overridable Property UserName As String Implements IMemberUsername.UserName
        End Class
    End Namespace

    Namespace AgentivityAPI.ServiceModel.Types

        <DataContract(Name:="ResponseMetadata", Namespace:="schemas.agentivity.com/types")>
        Public Partial Class AgentivityError
            <DataMember>
            Public Overridable Property ErrorCode As String

            <DataMember>
            Public Overridable Property Message As String

            <DataMember>
            Public Overridable Property StatusCode As String

            <DataMember>
            Public Overridable Property VerboseMessage As String
        End Class

        <DataContract(Name:="BookingSearchResult", Namespace:="schemas.agentivity.com/types")>
        Public Partial Class BookingSearchResult
            Implements IBookingCustomFields
            <DataMember(Order:=10)>
            Public Overridable Property AgentivityRef As Integer Implements IBookingCustomFields.AgentivityRef

            <DataMember(Order:=20)>
            Public Overridable Property RecordLocator As String

            <DataMember(Order:=30)>
            Public Overridable Property PNRCreationDate As Date?

            <DataMember(Order:=40)>
            Public Overridable Property Passengers As String

            <DataMember(Order:=50)>
            Public Overridable Property Account As String

            <DataMember(Order:=55)>
            Public Overridable Property OwningAgencyLocationID As String

            <DataMember(Order:=60)>
            Public Overridable Property OwningConsultant As String

            <DataMember(Order:=65)>
            Public Overridable Property OwningConsultantID As String

            <DataMember(Order:=70)>
            Public Overridable Property TravelDate As Date?

            <DataMember(Order:=80)>
            Public Overridable Property PnrTicketed As String

            <DataMember(Order:=90)>
            Public Overridable Property PnrCancelled As String

            <DataMember(Order:=100)>
            Public Overridable Property AirSegBookingCodeList As String

            <DataMember(Order:=110)>
            Public Overridable Property IsFrequentFlyer As Boolean?

            <DataMember(Order:=120)>
            Public Overridable Property ItineraryChanges As Integer?

            <DataMember(Order:=130)>
            Public Overridable Property CustomFields As CustomFieldsCollection Implements IBookingCustomFields.CustomFields
        End Class

        <DataContract(Name:="CacheMetadata", Namespace:="schemas.agentivity.com/types")>
        Public Partial Class CacheMetadata
            <DataMember(Order:=1)>
            Public Overridable Property CachedAt As Date

            <DataMember(Order:=2)>
            Public Overridable Property CacheExpiresAt As Date

            <DataMember(Order:=0)>
            Public Overridable Property IsFromCache As Boolean
        End Class

        <DataContract(Name:="CustomField", Namespace:="schemas.agentivity.com/types")>
        Public Partial Class CustomFieldData
            <DataMember(Order:=20)>
            Public Overridable Property FieldName As String

            <DataMember(Order:=30)>
            Public Overridable Property FieldValue As String
        End Class

        Public Partial Class CustomFieldsCollection
            Inherits List(Of CustomFieldData)
        End Class

        <DataContract(Namespace:="schemas.agentivity.com/types")>
        Public Partial Class FindBookings
            Inherits CompanyLevelRequestBase
            '''<Summary>
            '''Record locator
            '''</Summary>
            <DataMember>
            Public Overridable Property RecordLocator As String

            '''<Summary>
            '''Airline locator
            '''</Summary>
            <DataMember>
            Public Overridable Property AirlineLocator As String

            '''<Summary>
            '''Surname
            '''</Summary>
            <DataMember>
            Public Overridable Property Surname As String

            '''<Summary>
            '''Comma Delimited List of Custom Fields
            '''</Summary>
            <DataMember>
            Public Overridable Property CustomField As String()
        End Class

        <DataContract(Name:="AgentivityResponse", Namespace:="schemas.agentivity.com/types")>
        Public Partial Class FindBookingsItemResponse
            Inherits ItemResponse(Of BookingSearchResult, FindBookingsResponseReport)
        End Class

        <DataContract(Name:="BookingSearchResult", Namespace:="schemas.agentivity.com/types")>
        Public Partial Class FindBookingsResponseReport
            Inherits Report(Of FindBookingsItemResponse, BookingSearchResult)
        End Class

        <DataContract(Name:="Metadata", Namespace:="schemas.agentivity.com/types")>
        Public Partial Class PagingMetadata
            '''<Summary>
            '''Starting Record
            '''</Summary>
            <DataMember>
            <ApiMember(DataType:="string", Description:="Starting Record", Name:="Offset", ParameterType:="query")>
            Public Overridable Property Offset As String

            '''<Summary>
            '''Number of records to return (PageSize)
            '''</Summary>
            <DataMember>
            <ApiMember(DataType:="string", Description:="Number of records to return (PageSize)", Name:="Limit", ParameterType:="query")>
            Public Overridable Property Limit As String

            '''<Summary>
            '''Total Number of Records in a Full Reponse (if no paging)
            '''</Summary>
            <DataMember>
            <ApiMember(DataType:="string", Description:="Total Number of Records in a Full Reponse (if no paging)", Name:="TotalRecords", ParameterType:="query")>
            Public Overridable Property TotalRecords As Integer

            '''<Summary>
            '''Total Number of Records in this Reponse (on this page)
            '''</Summary>
            <DataMember>
            <ApiMember(DataType:="string", Description:="Total Number of Records in this Reponse (on this page)", Name:="ResponseRecords", ParameterType:="query")>
            Public Overridable Property ResponseRecords As Integer
        End Class

        <DataContract(Name:="ResponseMetadata", Namespace:="schemas.agentivity.com/types")>
        Public Partial Class ResponseMetadata
            <DataMember(Order:=0)>
            Public Overridable Property Success As Boolean

            <DataMember(Order:=1)>
            Public Overridable Property HasCache As Boolean

            <DataMember(Order:=2)>
            Public Overridable Property HasPaging As Boolean

            <DataMember(Order:=3, EmitDefaultValue:=false)>
            Public Overridable Property CacheMetadata As CacheMetadata

            <DataMember(Order:=4, EmitDefaultValue:=false)>
            Public Overridable Property PagingMetadata As PagingMetadata
        End Class
    End Namespace
End Namespace

VB.NET FindBookings DTOs

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

HTTP + CSV

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

GET /FindBookings HTTP/1.1 
Host: api.agentivity.com 
Accept: text/csv
HTTP/1.1 200 OK
Content-Type: text/csv
Content-Length: length

{"ResponseMetadata":{"Success":false,"HasCache":false,"HasPaging":false,"CacheMetadata":{"IsFromCache":false,"CachedAt":"\/Date(-62135596800000-0000)\/","CacheExpiresAt":"\/Date(-62135596800000-0000)\/"},"PagingMetadata":{"Offset":"String","Limit":"String","TotalRecords":0,"ResponseRecords":0}},"ResponseReport":{"Item":{"AgentivityRef":0,"RecordLocator":"String","PNRCreationDate":"\/Date(-62135596800000-0000)\/","Passengers":"String","Account":"String","OwningAgencyLocationID":"String","OwningConsultant":"String","OwningConsultantID":"String","TravelDate":"\/Date(-62135596800000-0000)\/","PnrTicketed":"String","PnrCancelled":"String","AirSegBookingCodeList":"String","IsFrequentFlyer":false,"ItineraryChanges":0,"CustomFields":[{"FieldName":"String","FieldValue":"String"}]}},"ResponseError":{"ErrorCode":"String","Message":"String","StatusCode":"String","VerboseMessage":"String"}}