Agentivity API

<back to all web services

FindBookings

The following routes are available for this service:
GET/FindBookings
import java.math.*;
import java.util.*;
import java.io.InputStream;
import net.servicestack.client.*;

public class dtos
{

    @DataContract(Namespace="schemas.agentivity.com/types")
    public static class FindBookings extends CompanyLevelRequestBase
    {
        /**
        * Record locator
        */
        @DataMember
        public String RecordLocator = null;

        /**
        * Airline locator
        */
        @DataMember
        public String AirlineLocator = null;

        /**
        * Surname
        */
        @DataMember
        public String Surname = null;

        /**
        * Comma Delimited List of Custom Fields
        */
        @DataMember
        public ArrayList<String> CustomField = null;
        
        public String getRecordLocator() { return RecordLocator; }
        public FindBookings setRecordLocator(String value) { this.RecordLocator = value; return this; }
        public String getAirlineLocator() { return AirlineLocator; }
        public FindBookings setAirlineLocator(String value) { this.AirlineLocator = value; return this; }
        public String getSurname() { return Surname; }
        public FindBookings setSurname(String value) { this.Surname = value; return this; }
        public ArrayList<String> getCustomField() { return CustomField; }
        public FindBookings setCustomField(ArrayList<String> value) { this.CustomField = value; return this; }
    }

    @DataContract(Namespace="schemas.agentivity.com/types")
    public static class CompanyLevelRequestBase extends PagingMetadata implements IMemberUsername, IMemberOwningCompanyCode
    {
        /**
        * Comma Delimited List of Owning Company Codes
        */
        @DataMember
        public ArrayList<String> OwningCompanyCode = null;

        /**
        * UserName in form of an email address
        */
        @DataMember
        public String UserName = null;
        
        public ArrayList<String> getOwningCompanyCode() { return OwningCompanyCode; }
        public CompanyLevelRequestBase setOwningCompanyCode(ArrayList<String> value) { this.OwningCompanyCode = value; return this; }
        public String getUserName() { return UserName; }
        public CompanyLevelRequestBase setUserName(String value) { this.UserName = value; return this; }
    }

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

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

        /**
        * 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 Integer TotalRecords = null;

        /**
        * 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 Integer ResponseRecords = null;
        
        public String getOffset() { return Offset; }
        public PagingMetadata setOffset(String value) { this.Offset = value; return this; }
        public String getLimit() { return Limit; }
        public PagingMetadata setLimit(String value) { this.Limit = value; return this; }
        public Integer getTotalRecords() { return TotalRecords; }
        public PagingMetadata setTotalRecords(Integer value) { this.TotalRecords = value; return this; }
        public Integer getResponseRecords() { return ResponseRecords; }
        public PagingMetadata setResponseRecords(Integer value) { this.ResponseRecords = value; return this; }
    }

    @DataContract(Name="AgentivityResponse", Namespace="schemas.agentivity.com/types")
    public static class FindBookingsItemResponse extends ItemResponse<BookingSearchResult, FindBookingsResponseReport>
    {
        
    }

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

        @DataMember(Order=2, EmitDefaultValue=false)
        public TReport ResponseReport = null;

        @DataMember(Order=3, EmitDefaultValue=false)
        public AgentivityError ResponseError = null;
        
        public ResponseMetadata getResponseMetadata() { return ResponseMetadata; }
        public ItemResponse<TItem, TReport> setResponseMetadata(ResponseMetadata value) { this.ResponseMetadata = value; return this; }
        public TReport getResponseReport() { return ResponseReport; }
        public ItemResponse<TItem, TReport> setResponseReport(TReport value) { this.ResponseReport = value; return this; }
        public AgentivityError getResponseError() { return ResponseError; }
        public ItemResponse<TItem, TReport> setResponseError(AgentivityError value) { this.ResponseError = value; return this; }
    }

    @DataContract(Name="ResponseMetadata", Namespace="schemas.agentivity.com/types")
    public static class ResponseMetadata
    {
        @DataMember(Order=0)
        public Boolean Success = null;

        @DataMember(Order=1)
        public Boolean HasCache = null;

        @DataMember(Order=2)
        public Boolean HasPaging = null;

        @DataMember(Order=3, EmitDefaultValue=false)
        public CacheMetadata CacheMetadata = null;

        @DataMember(Order=4, EmitDefaultValue=false)
        public PagingMetadata PagingMetadata = null;
        
        public Boolean isSuccess() { return Success; }
        public ResponseMetadata setSuccess(Boolean value) { this.Success = value; return this; }
        public Boolean isHasCache() { return HasCache; }
        public ResponseMetadata setHasCache(Boolean value) { this.HasCache = value; return this; }
        public Boolean isHasPaging() { return HasPaging; }
        public ResponseMetadata setHasPaging(Boolean value) { this.HasPaging = value; return this; }
        public CacheMetadata getCacheMetadata() { return CacheMetadata; }
        public ResponseMetadata setCacheMetadata(CacheMetadata value) { this.CacheMetadata = value; return this; }
        public PagingMetadata getPagingMetadata() { return PagingMetadata; }
        public ResponseMetadata setPagingMetadata(PagingMetadata value) { this.PagingMetadata = value; return this; }
    }

    @DataContract(Name="CacheMetadata", Namespace="schemas.agentivity.com/types")
    public static class CacheMetadata
    {
        @DataMember(Order=1)
        public Date CachedAt = null;

        @DataMember(Order=2)
        public Date CacheExpiresAt = null;

        @DataMember(Order=0)
        public Boolean IsFromCache = null;
        
        public Date getCachedAt() { return CachedAt; }
        public CacheMetadata setCachedAt(Date value) { this.CachedAt = value; return this; }
        public Date getCacheExpiresAt() { return CacheExpiresAt; }
        public CacheMetadata setCacheExpiresAt(Date value) { this.CacheExpiresAt = value; return this; }
        public Boolean getIsFromCache() { return IsFromCache; }
        public CacheMetadata setIsFromCache(Boolean value) { this.IsFromCache = value; return this; }
    }

    @DataContract(Name="ResponseMetadata", Namespace="schemas.agentivity.com/types")
    public static class AgentivityError
    {
        @DataMember
        public String ErrorCode = null;

        @DataMember
        public String Message = null;

        @DataMember
        public String StatusCode = null;

        @DataMember
        public String VerboseMessage = null;
        
        public String getErrorCode() { return ErrorCode; }
        public AgentivityError setErrorCode(String value) { this.ErrorCode = value; return this; }
        public String getMessage() { return Message; }
        public AgentivityError setMessage(String value) { this.Message = value; return this; }
        public String getStatusCode() { return StatusCode; }
        public AgentivityError setStatusCode(String value) { this.StatusCode = value; return this; }
        public String getVerboseMessage() { return VerboseMessage; }
        public AgentivityError setVerboseMessage(String value) { this.VerboseMessage = value; return this; }
    }

    @DataContract(Name="BookingSearchResult", Namespace="schemas.agentivity.com/types")
    public static class BookingSearchResult implements IBookingCustomFields
    {
        @DataMember(Order=10)
        public Integer AgentivityRef = null;

        @DataMember(Order=20)
        public String RecordLocator = null;

        @DataMember(Order=30)
        public Date PNRCreationDate = null;

        @DataMember(Order=40)
        public String Passengers = null;

        @DataMember(Order=50)
        public String Account = null;

        @DataMember(Order=55)
        public String OwningAgencyLocationID = null;

        @DataMember(Order=60)
        public String OwningConsultant = null;

        @DataMember(Order=65)
        public String OwningConsultantID = null;

        @DataMember(Order=70)
        public Date TravelDate = null;

        @DataMember(Order=80)
        public String PnrTicketed = null;

        @DataMember(Order=90)
        public String PnrCancelled = null;

        @DataMember(Order=100)
        public String AirSegBookingCodeList = null;

        @DataMember(Order=110)
        public Boolean IsFrequentFlyer = null;

        @DataMember(Order=120)
        public Integer ItineraryChanges = null;

        @DataMember(Order=130)
        public CustomFieldsCollection CustomFields = null;
        
        public Integer getAgentivityRef() { return AgentivityRef; }
        public BookingSearchResult setAgentivityRef(Integer value) { this.AgentivityRef = value; return this; }
        public String getRecordLocator() { return RecordLocator; }
        public BookingSearchResult setRecordLocator(String value) { this.RecordLocator = value; return this; }
        public Date getPnrCreationDate() { return PNRCreationDate; }
        public BookingSearchResult setPnrCreationDate(Date value) { this.PNRCreationDate = value; return this; }
        public String getPassengers() { return Passengers; }
        public BookingSearchResult setPassengers(String value) { this.Passengers = value; return this; }
        public String getAccount() { return Account; }
        public BookingSearchResult setAccount(String value) { this.Account = value; return this; }
        public String getOwningAgencyLocationID() { return OwningAgencyLocationID; }
        public BookingSearchResult setOwningAgencyLocationID(String value) { this.OwningAgencyLocationID = value; return this; }
        public String getOwningConsultant() { return OwningConsultant; }
        public BookingSearchResult setOwningConsultant(String value) { this.OwningConsultant = value; return this; }
        public String getOwningConsultantID() { return OwningConsultantID; }
        public BookingSearchResult setOwningConsultantID(String value) { this.OwningConsultantID = value; return this; }
        public Date getTravelDate() { return TravelDate; }
        public BookingSearchResult setTravelDate(Date value) { this.TravelDate = value; return this; }
        public String getPnrTicketed() { return PnrTicketed; }
        public BookingSearchResult setPnrTicketed(String value) { this.PnrTicketed = value; return this; }
        public String getPnrCancelled() { return PnrCancelled; }
        public BookingSearchResult setPnrCancelled(String value) { this.PnrCancelled = value; return this; }
        public String getAirSegBookingCodeList() { return AirSegBookingCodeList; }
        public BookingSearchResult setAirSegBookingCodeList(String value) { this.AirSegBookingCodeList = value; return this; }
        public Boolean getIsFrequentFlyer() { return IsFrequentFlyer; }
        public BookingSearchResult setIsFrequentFlyer(Boolean value) { this.IsFrequentFlyer = value; return this; }
        public Integer getItineraryChanges() { return ItineraryChanges; }
        public BookingSearchResult setItineraryChanges(Integer value) { this.ItineraryChanges = value; return this; }
        public CustomFieldsCollection getCustomFields() { return CustomFields; }
        public BookingSearchResult setCustomFields(CustomFieldsCollection value) { this.CustomFields = value; return this; }
    }

    public static class CustomFieldsCollection extends ArrayList<CustomFieldData>
    {
        
    }

    @DataContract(Name="CustomField", Namespace="schemas.agentivity.com/types")
    public static class CustomFieldData
    {
        @DataMember(Order=20)
        public String FieldName = null;

        @DataMember(Order=30)
        public String FieldValue = null;
        
        public String getFieldName() { return FieldName; }
        public CustomFieldData setFieldName(String value) { this.FieldName = value; return this; }
        public String getFieldValue() { return FieldValue; }
        public CustomFieldData setFieldValue(String value) { this.FieldValue = value; return this; }
    }

    @DataContract(Name="BookingSearchResult", Namespace="schemas.agentivity.com/types")
    public static class FindBookingsResponseReport extends Report<FindBookingsItemResponse, BookingSearchResult>
    {
        
    }

    @DataContract(Namespace="schemas.agentivity.com/types")
    public static class Report<TItemResponse, TItem>
    {
        @DataMember(Order=1, EmitDefaultValue=false)
        public TItem Item = null;
        
        public TItem getItem() { return Item; }
        public Report<TItemResponse, TItem> setItem(TItem value) { this.Item = value; return this; }
    }

}

Java 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"}}