Taxi Fare Finder Main Logo
TaxiFareFinder API (beta)
TaxiFareFinder provides an API for use in finding taxi fares. This API is currently in beta. As such, the following documentation should be considered provisional and subject to change. If you are interested in participating in the beta release, please contact us.
The TFF API allows third-party apps to determine a taxi fare between two geographic points. Getting a fare is accomplished via a fare api call, documented below. In order to get a fare, TFF currently requires that you provide an entity handle to denote the area in which the fare originates. Such a handle can be found either via the entity API as seen below, or by looking through the entity list on this page.
Related documents:
Request TFF API Key
Frequently Asked Question (FAQ)
TaxiFareFinder API Terms & Service

Finding the nearest supported city

http://api.taxifarefinder.com/entity?parameters
Returns the nearest TaxiFareFinder entity to the given coordinates. Each TFF supported entity is uniquely identified by a handle string, which is required for some API calls.
By default, this call returns the nearest city/town entity supported by TFF.

Required parameters:

key Valid TFF API key key
location lat/lng of location <float>,<float>

Optional parameters:

callback If provided, wrap JSON object in call to this javascript function (JSONP) function name
max_distance Maximum distance from entity in meters. Defaults to infinite integer
Returns a JSON object with the following properties:
statusstatus code
nameShort name for entity
full_nameLong name for entity
handleTFF handle for this entity
localeEntity's locale
distanceMeters from given location to entity

Getting a taxi fare

http://api.taxifarefinder.com/fare?parameters
Returns information about a particular taxi trip.

Required parameters:

key Valid TFF API key key
entity_handle Valid TFF entity handle entity handle
origin Origin lat/lng <float>,<float>
destination Destination lat/lng <float>,<float>

Optional parameters:

callback If provided, wrap JSON object in call to this javascript function (JSONP) function name
traffic Traffic level. Defaults to medium light|medium|heavy
Returns a JSON object with the following properties:
statusstatus code
distanceDistance in meters of the route used to calculate this fare.
durationDuration in seconds of the route used to calculate this fare.
total_fareTotal fare, including initial fare, metered fare, and tip.
initial_fareFlag drop charge, or charge for first portion of trip.
metered_fareAdditional metered fare based upon the length and duration of the trip.
flat_ratesArray of objects, each describing a flat rate that is applicable to this trip.
Each object contains the following properties:
     chargeAmount of charge.
     descriptionExplanation of charge.
extra_chargesArray of objects, each describing an extra charges that is applicable to this trip.
Each object contains the following properties:
     chargeAmount of charge.
     descriptionExplanation of charge.
tip_amountTip to add in addition to initial_fare + metered_fare.
tip_percentageTip percentage that was used, customary to this region.
localeCurrency used.
rate_areaName of municipality used for the rates. May differ from the entity passed in to this call, for instance if the entity is part of a larger metropolitan area which governs taxi rates.

Finding taxi companies for an entity

http://api.taxifarefinder.com/businesses?parameters
Returns TaxiFareFinder's list of local taxi businesses for an entity.

Required parameters:

key Valid TFF API key key
entity_handle entity handle entity handle

Optional parameters:

callback If provided, wrap JSON object in call to this javascript function (JSONP) function name
Returns a JSON object with the following properties:
statusstatus code
businessesArray of objects, each describing a taxi company local to this entity.
Each object contains the following properties:
     nameName of business
     phoneDispatch phone number of business
     typeBusiness type: currently only "taxi" type businesses are returned

Status codes

Possible status codes are:
OKResult found ok
NO_MATCHING_ENTITYNo entity found within given constraints
UNKNOWN_ENTITYNo entity with given entity handle found
MISSING_PARAMETERA required parameter is missing
UNKNOWN_PARAMETERA provided parameter is not valid for this API call
WRONG_PARAMETER_TYPEA given parameter value is of the wrong type
INVALID_KEYAPI key provided is invalid
INVALID_CALLBACKAn invalid JavaScript function name was provided for the JSONP callback
REQUEST_LIMIT_REACHEDDaily request limit for this API key has been reached
NO_ROUTE_FOUNDNo route could be found between origin and destination
LOCATION_NOT_FOUNDEither the origin or destination location could not be found
ERRORUnspecified error occurred

TFF API Supported Entity List

Supported Entities and Corresponding handles
Adelaide, SA, AustraliaAdelaide-South-Australia-SA-Australia
Albany, NYAlbany-NY
Albuquerque, NMAlbuquerque-NM
Alexandria, VAAlexandria-VA
Alice Springs, NT, AustraliaAlice-Springs-Northern-Territory-NT-Australia
Amarillo, TXAmarillo-TX
Amsterdam, NetherlandsAmsterdam-Netherlands
Anaheim, CAAnaheim-CA
Anchorage, AKAnchorage-AK
Ankara, TurkeyAnkara-Turkey
Ann Arbor, MIAnn-Arbor-MI
Annapolis, MDAnnapolis-MD
Antwerpen, BelgiumAntwerpen-Belgium
Arlington, VAArlington-VA
Arnhem, NetherlandsArnhem-Netherlands
Athens, GreeceAthens-Greece
Atlanta, GAAtlanta
Auckland, New ZealandAuckland-New-Zealand
Austin, TXAustin-TX
Baku, AzerbaijanBaku-Azerbaijan
Ballarat, VIC, AustraliaBallarat-Victoria-VIC-Australia
Baltimore, MDBaltimore
Bandung, West Java, IndonesiaBandung-Indonesia
Bangalore, IndiaBangalore-India
Barcelona, SpainBarcelona-Spain
Basel, SwitzerlandBasel-Switzerland
Bath, United KingdomBath-UK-United-Kingdom
Baton Rouge, LABaton-Rouge-LA
Beijing, ChinaBeijing-China
Bendigo, VIC, AustraliaBendigo-Victoria-VIC-Australia
Berlin, GermanyBerlin-Germany
Birmingham, ALBirmingham-AL
Birmingham, United KingdomBigmingham-UK-United-Kingdom
Blue Mountains, NSW, AustraliaBlue-Mountains-New-South-Wales-NSW-Australia
Bogotá, Bogota, ColombiaBogota-Bogota-Colombia
Boise, IDBoise-ID
Bologna, ItalyBologna-Italy
Bordeaux, FranceBordeaux-France
Boston, MABoston
Boulder, COBoulder-CO
Bray, Co. Wicklow, IrelandBray-Wicklow-Ireland
Brighton, United KingdomBrighton-United-Kingdom
Brisbane, QLD, AustraliaBrisbane-Queenland-QLD-Australia
Brno, Czech RepublicBrno-Czech-Republic
Brussels, BelgiumBrussels-Belgium
Budapest, HungaryBudapest-Hungary
Buenos Aires, ArgentinaBuenos-Aires-Argentina
Buffalo, NYBuffalo
Burbank, CABurbank-CA
Cairo, EgyptCairo-Egypt
Calgary, AB, CanadaCalgary
Cali, Valle del Cauca, ColombiaCali-Valle-del-Cauca-Colombia
Cambridge, MACambridge-MA
Cambridge, United KingdomCambridge-UK-United-Kingdom
Canberra, ACT, AustraliaCanberra-Australian-Capital-Territory-ACT-Australia
Cape Town, South AfricaCape-Town-South-Africa
Cardiff, United KingdomCardiff-UK-United-Kingdom
Cascais, PortugalCascais-Portugal
Córdoba, ArgentinaCordoba-Argentina
Cedar Rapids, IACedar-Rapids-IA
Champaign/Urbana, ILChampaign-Urbana-IL
Chandler, AZChandler-AZ
Chapel Hill, NCChapel-Hill-NC
Charleston, SCCharleston-SC
Charlotte, NCCharlotte-NC
Chengdu, Sichuan, ChinaChengdu-Sichuan-China
Chicago, ILChicago
Cincinnati, OHCincinnati-OH
Cleveland, OHCleveland
Cologne, GermanyCologne-Germany
Colorado Springs, COColorado-Springs-CO
Columbia, SCColumbia-SC
Columbus, OHColumbus-OH
Copenhagen, DenmarkCopenhagen-Denmark
Cork, Co. Cork, IrelandCork-Cork-Ireland
Corpus Christi, TXCorpus-Christi-TX
Costa Mesa, CACosta-Mesa-CA
Cucuta, North Santander, ColombiaCucuta-North-Santander-Colombia
Dallas, TXDallas
Darwin, NT, AustraliaDarwin-Northern-Territory-NT-Australia
Düsseldorf, GermanyDusseldorf-Germany
Denver, CODenver
Des Moines, IADes-Moines-IA
Detroit, MIDetroit
Downey, CADowney-CA
Dresden, GermanyDresden-Germany
Drogheda, Co. Louth, IrelandDrogheda-Louth-Ireland
Dubai, UAEDubai-UAE
Dublin, Co. Dublin, IrelandDublin-Ireland
Duluth, MNDuluth-MN
Dundalk, Co. Louth, IrelandDundalk-Louth-Ireland
Durban, KwaZulu-Natal, South AfricaDurban-KwaZulu-Natal-South-Africa
Durham, NCDurham-NC
Ecatepec de Morelos, MexicoEcatepec-de-Morelos-Mexico
Edinburgh, United KingdomEdinburgh-UK-United-Kingdom
Edmonton, AB, CanadaEdmonton
Eindhoven, NetherlandsEindhoven-Netherlands
El Monte, CAEl-Monte-CA
El Paso, TXEl-Paso-TX
Encinitas, CAEncinitas-CA
Ennis, Co. Clare, IrelandEnnis-Clare-Ireland
Erie, PAErie-PA
Espoo, FinlandEspoo-Finland
Eugene, OREugene-OR
Fargo, NDFargo-ND
Fingal, Co. Dublin, IrelandFingal-Dublin-Ireland
Florence, ItalyFlorence-Italy
Fontana, CAFontana-CA
Fort Lauderdale, FLFort-Lauderdale-FL
Fort Worth, TXFort-Worth-TX
Fortaleza, Ceará, BrazilFortaleza-Ceara-Brazil
Frankfurt, GermanyFrankfurt-Germany
Fresno, CAFresno-CA
Fukuoka, JapanFukuoka-Japan
Fullerton, CAFullerton-CA
Gainesville, FLGainesville-FL
Galway, Co. Galway, IrelandGalway-Galway-Ireland
Garden Grove, CAGarden-Grove-CA
Gatineau, QC, CanadaGatineau
Gdansk, PolandGdansk-Poland
Geelong, VIC, AustraliaGeelong-Victoria-VIC-Australia
Geneva, SwitzerlandGeneva-Switzerland
Genoa, ItalyGenoa-Italy
George Town, Penang, MalaysiaGeorge-Town-Penang-Malaysia
Ghent, BelgiumGhent-Belgium
Gilbert, AZGilbert-AZ
Glasgow, United KingdomGlasgow-UK-United-Kingdom
Glendale, AZGlendale-AZ
Glendale, CAGlendale-CA
Gold Coast, QLD, AustraliaGold-Coast-Queensland-QLD-Australia
Gosford, NSW, AustraliaGosford-New-South-Wales-NSW-Australia
Guadalajara, Jalisco, MexicoGuadalajara-Jalisco-Mexico
Guilin, Guangxi, ChinaGuilin-Guangxi-China
Haarlem, NetherlandsHaarlem-Netherlands
Halifax, NS, CanadaHalifax
Hamburg, GermanyHamburg-Germany
Hamilton, ON, CanadaHamilton
Hangzhou, Zhejiang, ChinaHangzhou-Zhejiang-China
Harrisburg, PAHarrisburg-PA
Hartford, CTHartford-CT
Helsinki, FinlandHelsinki-Finland
Hiroshima, JapanHiroshima-Japan
Hobart, TAS, AustraliaHobart-Tasmania-TAS-Australia
Hong Kong, ChinaHong-Kong-China
Honolulu, HIHonolulu
Houston, TXHouston
Huntington Beach, CAHuntington-Beach-CA
Hyderabad, IndiaHyderabad-India
Indianapolis, INIndianapolis-IN
Inglewood, CAInglewood-CA
Iowa City, IAIowa-City-IA
Irvine, CAIrvine-CA
Istanbul, TurkeyIstanbul-Turkey
Izmir, TurkeyIzmir-Turkey
Jackson, MSJackson-MS
Jacksonville, FLJacksonville-FL
Jakarta, Capital Region, IndonesiaJakarta-Indonesia
Jersey City, NJJersey-City-NJ
Johannesburg, South AfricaJohannesburg-South-Africa
Kansas City, MOKC
Kawasaki, Kanagawa, JapanKawasaki-Kanagawa-Japan
Kazan, RussiaKazan-Russia
Kilkenny, Co. Kilkenny, IrelandKilkenny-Kilkenny-Ireland
Knoxville, TNKnoxville-TN
Kobe, Hyogo, JapanKobe-Hyogo-Japan
Kraków, PolandKrakow-Poland
Kuala Lumpur, MalaysiaKuala-Lumpur-Malaysia
Kyoto, JapanKyoto-Japan
Lancaster, CALancaster-CA
Las Vegas, NVLV
Launceston, TAS, AustraliaLaunceston-Tasmania-TAS-Australia
Lausanne, SwitzerlandLausanne-Switzerland
Leeds, United KingdomLeeds-UK-United-Kingdom
Leipzig, GermanyLeipzig-Germany
Lewisburg, PALewisburg-PA
Lexington, KYLexington-KY
Liege, BelgiumLiege-Belgium
Limerick, Co. Limerick, IrelandLimerick-Limerick-Ireland
Lincoln, NELincoln-NE
Lisbon, PortugalLisbon-Portugal
Liverpool, United KingdomLiverpool-Merseyside-UK-United-Kingdom
London, United KingdomLondon
Long Beach, CALong-Beach-CA
Los Angeles, CALA
Louisville, KYLouisville-KY
Lublin, PolandLublin-Poland
Lucerne, SwitzerlandLucerne-Switzerland
Lyon, FranceLyon-France
Macau, ChinaMacau-China
Madison, WIMadison-WI
Madrid, SpainMadrid-Spain
Malacca City, Malacca, MalaysiaMalacca-Melaka-Malaysia
Malaga, SpainMalaga-Spain
Manchester, United KingdomManchester-UK-United-Kingdom
Manistee, MIManistee-MI
Marseille, FranceMarseille-France
Medan, West Java, IndonesiaMedan-Indonesia
Medellin, Antioquia, ColombiaMedellin-Antioquia-Colombia
Melbourne, VIC, AustraliaMelbourne-Victoria-VIC-Australia
Memphis, TNMemphis-TN
Mesa, AZMesa-AZ
Mexico City, MexicoMexico-City-Mexico
Miami, FLMiami
Milan, ItalyMilan-Italy
Milwaukee, WIMilwaukee
Minneapolis, MNMinneapolis
Minsk, BelarusMinsk-Belarus
Monterrey, MexicoMonterrey-Mexico
Montgomery, ALMontgomery-AL
Montreal, QC, CanadaMontreal
Moscow, RussiaMoscow-Russia
Mumbai, IndiaMumbai-India
Munich, GermanyMunich-Germany
Nagoya, Aichi, JapanNagoya-Aichi-Japan
Namur, BelgiumNamur-Belgium
Naples, ItalyNaples-Italy
Nashville, TNNashville-TN
Navan, Co. Meath, IrelandNavan-Meath-Ireland
New Delhi, IndiaNew-Delhi-India
New Haven, CTNew-Haven-CT
New Orleans, LANew-Orleans-LA
New York, NYNY
Newark, NJNewark-NJ
Newcastle, NSW, AustraliaNewcastle-New-South-Wales-NSW-Australia
Newport, RINewport-RI
Newton, MANewton-MA
Nice, FranceNice-France
Nizhny Novgorod, RussiaNizhny-Novgorod-Russia
Norfolk, VANorfolk-VA
Norwalk, CANorwalk-CA
Nottingham, United KingdomNottingham-UK-United-Kingdom
Novosibirsk, RussiaNovosibirsk-Russia
Oakland, CAOakland-CA
Oklahoma City, OKOklahoma-City-OK
Omaha / Council Bluffs, NEOmaha-NE
Ontario, CAOntario-CA
Orange County, CAOrange-County-CA
Orlando, FLOrlando
Osaka, JapanOsaka-Japan
Oslo, NorwayOslo-Norway
Ottawa, ON, CanadaOttawa
Oulu, FinlandOulu-Finland
Oxford, United KingdomOxford-UK-United-Kingdom
Palm Beach, FLPalm-Beach-FL
Palma de Majorca, SpainPalma-de-Majorca-Spain
Palmdale, CAPalmdale-CA
Paris, FranceParis-France
Pasadena, CAPasadena-CA
Patrás, Achaea, GreecePatras-Patra-Achaea-Greece
Peoria, AZPeoria-AZ
Perth, WA, AustraliaPerth-Western-Australia-WA-Australia
Petaling Jaya, Selangor, MalaysiaPetaling-Jaya-Selangor
Philadelphia, PAPhiladelphia
Phoenix, AZPhoenix
Pittsburgh, PAPittsburgh
Plano, TXPlano-TX
Pomona, CAPomona-CA
Port Elizabeth, Eastern Cape, South AfricaPort-Elizabeth-Eastern-Cape-South-Africa
Portland, ORPortland
Portland, MEPortland-ME
Porto, PortugalPorto-Oporto-Portugal
Porto Alegre, Rio Grande do Sul, BrazilPorto-Alegre-Rio-Grande-do-Sul-Brazil
Prague, Czech RepublicPrague-Czech-Republic
Pretoria, Gauteng, South AfricaPretoria-Gauteng-South-Africa
Princeton, NJPrinceton-NJ
Providence, RIProvidence-RI
Quebec City, QC, CanadaQuebec-City-QC
Raleigh, NCRaleigh-NC
Rancho Cordova, CARancho-Cordova
Rancho Cucamonga, CARancho-Cucamonga-CA
Regina, SK, CanadaRegina
Revere, MARevere-MA
Richmond, VARichmond-VA
Rio de Janeiro, BrazilRio-de-Janeiro-Brazil
Riverside, CARiverside-CA
Rochester, NYRochester-NY
Rome, ItalyRome-Italy
Sacramento, CASacramento-CA
Saitama, JapanSaitama-Japan
Salt Lake City, UTSLC
Salvador, Bahia, BrazilSalvador-Bahia-Brazil
Salzburg, AustriaSalzburg-Austria
Samara, RussiaSamara-Russia
San Antonio, TXSan-Antonio-TX
San Bernardino, CASan-Bernardino-CA
San Diego, CASD
San Francisco, CASF
San José, Costa RicaSan-Jose-Costa-Rica
San Jose, CASan-Jose-CA
San Juan, Puerto RicoSan-Juan-Puerto-Rico
Santa Ana, CASanta-Ana-CA
Santa Clarita, CASanta-Clarita-CA
Santiago, ChileSantiago-Chile
Santo Domingo, Dominican RepublicSanto-Domingo-Dominican-Republic
Sapporo, Hokkaido, JapanSapporo-Hokkaido-Japan
Saskatoon, SK, CanadaSaskatoon
Savannah, GASavannah-GA
São Paulo, BrazilSao-Paulo-Brazil
Scottsdale, AZScottsdale-AZ
Seattle, WASeattle
Sendai, Miyagi, JapanSendai-Miyagi-Japan
Seville, SpainSeville-Spain
Shanghai, ChinaShanghai-China
Simi Valley, CASimi-Valley-CA
Sofia, BulgariaSofia-Bulgaria
Spokane, WASpokane-WA
Springfield, MOSpringfield-MO
St. Louis, MOSL
St. Paul, MNSt.-Paul-MN
St. Petersburg, FLSt.-Petersburg-FL
Stanford, CAStanford-CA
Strasbourg, FranceStrasbourg-France
Stuttgart, GermanyStuttgart-Germany
Surabaya, East Java, IndonesiaSurabaya-Indonesia
Surprise, AZSurprise-AZ
Swords, Fingal, IrelandSwords-Fingal-Ireland
Sydney, AustraliaSydney-Australia
Syracuse, NYSyracuse-NY
Tacoma, WATacoma-WA
Tallahassee, FLTallahassee-FL
Tallinn, EstoniaTallinn-Estonia
Tampa, FLTampa-FL
Tampere, FinlandTampere-Finland
Tegucigalpa, HondurasTegucigalpa-Honduras
Tempe, AZTempe-AZ
Tokyo, JapanTokyo-Japan
Toledo, OHToledo-OH
Toronto, ON, CanadaToronto
Torrance, CATorrance-CA
Toulouse, FranceToulouse-France
Trenton, NJTrenton-NJ
Trondheim, NorwayTrondheim-Norway
Troy, NYTroy-NY
Tucson, AZTucson-AZ
Tulsa, OKTulsa-OK
Turin, ItalyTurin-Italy
Turku, FinlandTurku-Finland
Utrecht, NetherlandsUtrecht-Netherlands
Valencia, SpainValencia-Spain
Vancouver, BC, CanadaVancouver
Vantaa, FinlandVantaa-Finland
Venice, ItalyVenice-Italy
Victoria, BC, CanadaVictoria
Vienna, AustriaVienna-Austria
Virginia Beach, VAVirginia-Beach-VA
Waltham, MAWaltham-MA
Warsaw, PolandWarsaw-Poland
Washington, DCWashington-DC
Waterford, Co. Waterford, IrelandWaterford-Waterford-Ireland
West Covina, CAWest-Covina-CA
Wichita, KSWichita-KS
Winchester, VAWinchester-VA
Winnipeg, MB, CanadaWinnipeg
Wollongong, NSW, AustraliaWollongong-New-South-Wales-NSW-Australia
Worcester, MAWorcester-MA
Wroclaw, PolandWroclaw-Poland
Xi'an, Shaanxi, ChinaXian-Shaanxi-China
Xiamen, Fujian, ChinaXiamen-Fujian-China
Yekaterinburg, RussiaYekaterinburg-Russia
Yellowknife, NT, CanadaYellowknife
Yerevan, ArmeniaYerevan-Armenia
Yokohama, Kanagawa, JapanYokohama-Kanagawa-Japan
Zagreb, CroatiaZagreb-Croatia
Zaragoza, SpainZaragoza-Spain
Zurich, SwitzerlandZurich-Switzerland
Łódź, PolandLodz-Poland