Agentivity API

<back to all web services

GetPassengerDepartures

The following routes are available for this service:
GET/PassengerDepartures
import Foundation
import ServiceStack

// @DataContract(Namespace="schemas.agentivity.com/types")
public class GetPassengerDepartures : CompanyLevelRequestBase
{
    /**
    * Comma Delimited List of Accounts
    */
    // @DataMember
    public var account:[String]

    /**
    * Name of the class
    */
    // @DataMember
    public var className:[String]

    /**
    * Carrier name
    */
    // @DataMember
    public var carrier:[String]

    /**
    * Date in format YYYYMMDD
    */
    // @DataMember
    public var travelDateStart:String

    /**
    * Date in format YYYYMMDD
    */
    // @DataMember
    public var travelDateEnd:String

    /**
    * Include items with SMS sent in response
    */
    // @DataMember
    public var withSMS:Bool?

    /**
    * Add transfers
    */
    // @DataMember
    public var addVouchers:Bool

    /**
    * Add transfers
    */
    // @DataMember
    public var addTransfers:Bool

    /**
    * Include Itinerary in the response
    */
    // @DataMember
    public var includeItinerary:Bool

    /**
    * Return only PNRs that are or are not flagged as VIP bookings
    */
    // @DataMember
    public var isVip:Bool?

    /**
    * Show SMS
    */
    // @DataMember
    public var showSMS:Bool

    /**
    * Indicates the required formatting: 0=None(Default); 1= Html; 2 = Chart
    */
    // @DataMember
    public var itineraryFormatting:FormattingStyle

    required public init(){ super.init() }

    private enum CodingKeys : String, CodingKey {
        case account
        case className
        case carrier
        case travelDateStart
        case travelDateEnd
        case withSMS
        case addVouchers
        case addTransfers
        case includeItinerary
        case isVip
        case showSMS
        case itineraryFormatting
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        account = try container.decodeIfPresent([String].self, forKey: .account) ?? []
        className = try container.decodeIfPresent([String].self, forKey: .className) ?? []
        carrier = try container.decodeIfPresent([String].self, forKey: .carrier) ?? []
        travelDateStart = try container.decodeIfPresent(String.self, forKey: .travelDateStart)
        travelDateEnd = try container.decodeIfPresent(String.self, forKey: .travelDateEnd)
        withSMS = try container.decodeIfPresent(Bool.self, forKey: .withSMS)
        addVouchers = try container.decodeIfPresent(Bool.self, forKey: .addVouchers)
        addTransfers = try container.decodeIfPresent(Bool.self, forKey: .addTransfers)
        includeItinerary = try container.decodeIfPresent(Bool.self, forKey: .includeItinerary)
        isVip = try container.decodeIfPresent(Bool.self, forKey: .isVip)
        showSMS = try container.decodeIfPresent(Bool.self, forKey: .showSMS)
        itineraryFormatting = try container.decodeIfPresent(FormattingStyle.self, forKey: .itineraryFormatting)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
        var container = encoder.container(keyedBy: CodingKeys.self)
        if account != nil { try container.encode(account, forKey: .account) }
        if className != nil { try container.encode(className, forKey: .className) }
        if carrier != nil { try container.encode(carrier, forKey: .carrier) }
        if travelDateStart != nil { try container.encode(travelDateStart, forKey: .travelDateStart) }
        if travelDateEnd != nil { try container.encode(travelDateEnd, forKey: .travelDateEnd) }
        if withSMS != nil { try container.encode(withSMS, forKey: .withSMS) }
        if addVouchers != nil { try container.encode(addVouchers, forKey: .addVouchers) }
        if addTransfers != nil { try container.encode(addTransfers, forKey: .addTransfers) }
        if includeItinerary != nil { try container.encode(includeItinerary, forKey: .includeItinerary) }
        if isVip != nil { try container.encode(isVip, forKey: .isVip) }
        if showSMS != nil { try container.encode(showSMS, forKey: .showSMS) }
        if itineraryFormatting != nil { try container.encode(itineraryFormatting, forKey: .itineraryFormatting) }
    }
}

// @DataContract(Namespace="schemas.agentivity.com/types")
public class CompanyLevelRequestBase : PagingMetadata, IMemberUsername, IMemberOwningCompanyCode
{
    /**
    * Comma Delimited List of Owning Company Codes
    */
    // @DataMember
    public var owningCompanyCode:[String]

    /**
    * UserName in form of an email address
    */
    // @DataMember
    public var userName:String

    required public init(){ super.init() }

    private enum CodingKeys : String, CodingKey {
        case owningCompanyCode
        case userName
    }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
        let container = try decoder.container(keyedBy: CodingKeys.self)
        owningCompanyCode = try container.decodeIfPresent([String].self, forKey: .owningCompanyCode) ?? []
        userName = try container.decodeIfPresent(String.self, forKey: .userName)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
        var container = encoder.container(keyedBy: CodingKeys.self)
        if owningCompanyCode != nil { try container.encode(owningCompanyCode, forKey: .owningCompanyCode) }
        if userName != nil { try container.encode(userName, forKey: .userName) }
    }
}

// @DataContract(Name="Metadata", Namespace="schemas.agentivity.com/types")
public class PagingMetadata : Codable
{
    /**
    * Starting Record
    */
    // @DataMember
    // @ApiMember(DataType="string", Description="Starting Record", Name="Offset", ParameterType="query")
    public var offset:String

    /**
    * Number of records to return (PageSize)
    */
    // @DataMember
    // @ApiMember(DataType="string", Description="Number of records to return (PageSize)", Name="Limit", ParameterType="query")
    public var limit:String

    /**
    * Total Number of Records in a Full Reponse (if no paging)
    */
    // @DataMember
    // @ApiMember(DataType="string", Description="Total Number of Records in a Full Reponse (if no paging)", Name="TotalRecords", ParameterType="query")
    public var totalRecords:Int

    /**
    * Total Number of Records in this Reponse (on this page)
    */
    // @DataMember
    // @ApiMember(DataType="string", Description="Total Number of Records in this Reponse (on this page)", Name="ResponseRecords", ParameterType="query")
    public var responseRecords:Int

    required public init(){}
}

// @Flags()
public enum FormattingStyle : Int, Codable
{
    case None = 0
    case Html = 1
    case Charting = 2
}

// @DataContract(Name="AgentivityResponse", Namespace="schemas.agentivity.com/types")
public class PassengerDeparturesItemResponse : ItemResponse<PassengerDeparture, PassengerDeparturesResponseReport>
{
    required public init(){ super.init() }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
    }
}

// @DataContract(Name="AgentivityResponse", Namespace="schemas.agentivity.com/types")
public class ItemResponse<TItem : Codable, TReport : Codable> : Codable
{
    // @DataMember(Order=1)
    public var responseMetadata:ResponseMetadata

    // @DataMember(Order=2, EmitDefaultValue=false)
    public var responseReport:TReport

    // @DataMember(Order=3, EmitDefaultValue=false)
    public var responseError:AgentivityError

    required public init(){}
}

// @DataContract(Name="ResponseMetadata", Namespace="schemas.agentivity.com/types")
public class ResponseMetadata : Codable
{
    // @DataMember(Order=0)
    public var success:Bool

    // @DataMember(Order=1)
    public var hasCache:Bool

    // @DataMember(Order=2)
    public var hasPaging:Bool

    // @DataMember(Order=3, EmitDefaultValue=false)
    public var cacheMetadata:CacheMetadata

    // @DataMember(Order=4, EmitDefaultValue=false)
    public var pagingMetadata:PagingMetadata

    required public init(){}
}

// @DataContract(Name="CacheMetadata", Namespace="schemas.agentivity.com/types")
public class CacheMetadata : Codable
{
    // @DataMember(Order=1)
    public var cachedAt:Date

    // @DataMember(Order=2)
    public var cacheExpiresAt:Date

    // @DataMember(Order=0)
    public var isFromCache:Bool

    required public init(){}
}

// @DataContract(Name="ResponseMetadata", Namespace="schemas.agentivity.com/types")
public class AgentivityError : Codable
{
    // @DataMember
    public var errorCode:String

    // @DataMember
    public var message:String

    // @DataMember
    public var statusCode:String

    // @DataMember
    public var verboseMessage:String

    required public init(){}
}

// @DataContract(Name="PassengerDeparture", Namespace="schemas.agentivity.com/types")
public class PassengerDeparture : IBookingItinerary, Codable
{
    // @DataMember(Order=10)
    public var agentivityRef:Int

    // @DataMember(Order=20)
    public var recordLocator:String

    // @DataMember(Order=25)
    public var owningAgencyLocationID:String

    // @DataMember(Order=30)
    public var owningConsultant:String

    // @DataMember(Order=35)
    public var owningConsultantID:String

    // @DataMember(Order=40)
    public var gdsCode:String

    // @DataMember(Order=45)
    public var passenger:String

    // @DataMember(Order=50)
    public var account:String

    // @DataMember(Order=60)
    public var travelDate:Date?

    // @DataMember(Order=70)
    public var ticketedStatusCode:String

    // @DataMember(Order=75)
    public var ticketedStatus:String

    // @DataMember(Order=80)
    public var supplierReference:String

    // @DataMember(Order=85)
    public var sms:String

    // @DataMember(Order=90)
    public var vouchers:String

    // @DataMember(Order=100)
    public var transfers:String

    // @DataMember(Order=110)
    public var isVip:Bool

    // @DataMember(Order=120)
    public var phoneNbr:String

    // @DataMember(Order=130)
    public var emailAddress:String

    // @DataMember(Order=140)
    public var destinationCities:String

    // @DataMember(Order=150)
    public var destinationCountries:String

    // @DataMember(Order=160)
    public var connections:String

    // @DataMember(Order=200)
    public var itinerary:ItinerarySegmentsCollection

    // @DataMember(Order=210)
    public var itineraryFormatted:String

    required public init(){}
}

public class ItinerarySegmentsCollection : List<ItinerarySegment>
{
    required public init(){ super.init() }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
    }
}

// @DataContract(Name="ItinerarySegment", Namespace="schemas.agentivity.com/types")
public class ItinerarySegment : Codable
{
    // @DataMember
    public var segmentType:String

    // @DataMember
    public var segmentNbr:Int

    // @DataMember
    public var boardPoint:String

    // @DataMember
    public var offPoint:String

    // @DataMember
    public var operatorCode:String

    // @DataMember
    public var operatorService:String

    // @DataMember
    public var segmentStatus:String

    // @DataMember
    public var departureTimeFormatted:String

    // @DataMember
    public var arrivalTimeFormatted:String

    // @DataMember
    public var changeOfDayFormatted:String

    // @DataMember
    public var serviceCode:String

    // @DataMember
    public var startDate:String

    // @DataMember
    public var endDate:String

    // @DataMember
    public var ticketNumber:String

    /**
    * Comma separated list of vendor locators
    */
    // @DataMember
    public var vendorLocators:String

    // @DataMember
    public var equipmentCode:String

    // @DataMember
    public var equipment:String

    required public init(){}
}

// @DataContract(Name="PassengerDeparture", Namespace="schemas.agentivity.com/types")
public class PassengerDeparturesResponseReport : Report<PassengerDeparturesItemResponse, PassengerDeparture>
{
    required public init(){ super.init() }

    required public init(from decoder: Decoder) throws {
        try super.init(from: decoder)
    }

    public override func encode(to encoder: Encoder) throws {
        try super.encode(to: encoder)
    }
}

// @DataContract(Namespace="schemas.agentivity.com/types")
public class Report<TItemResponse : Codable, TItem : Codable> : Codable
{
    // @DataMember(Order=1, EmitDefaultValue=false)
    public var item:TItem

    required public init(){}
}


Swift GetPassengerDepartures 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 /PassengerDepartures 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","OwningAgencyLocationID":"String","OwningConsultant":"String","OwningConsultantID":"String","GdsCode":"String","Passenger":"String","Account":"String","TravelDate":"\/Date(-62135596800000-0000)\/","TicketedStatusCode":"String","TicketedStatus":"String","SupplierReference":"String","SMS":"String","Vouchers":"String","Transfers":"String","IsVip":false,"PhoneNbr":"String","EmailAddress":"String","DestinationCities":"String","DestinationCountries":"String","Connections":"String","Itinerary":[{"SegmentType":"String","SegmentNbr":0,"BoardPoint":"String","OffPoint":"String","OperatorCode":"String","OperatorService":"String","SegmentStatus":"String","DepartureTimeFormatted":"String","ArrivalTimeFormatted":"String","ChangeOfDayFormatted":"String","ServiceCode":"String","StartDate":"String","EndDate":"String","TicketNumber":"String","VendorLocators":"String","EquipmentCode":"String","Equipment":"String"}],"ItineraryFormatted":"String"}},"ResponseError":{"ErrorCode":"String","Message":"String","StatusCode":"String","VerboseMessage":"String"}}