find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/aplusz-app:aplusz-app-fare-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: AplusZ Fare API
  version: 1.0.0
  summary: I want to fly from <city A> to <city B> - what is the cheapest fare, what was the 6-month low, and which date is cheapest to book?
  description: 'Keyless read API over AplusZ''s scanned fare data. Same resolver as the human pages and the MCP tools. Prices are cached snapshots, never live quotes. Full brief: https://aplusz.app/llms-full.txt'
  contact:
    name: AplusZ
    email: dagrang@gmail.com
    url: https://aplusz.app
  license:
    name: RSL - search, ai-input and ai-train permitted
    url: https://aplusz.app/license.xml
servers:
- url: https://aplusz.app
tags:
- name: Fare
paths:
  /v1/fare:
    get:
      operationId: getFare
      summary: How much is the cheapest flight from city A to city B, and what was the 6-month…
      description: Returns one fare record for one directional city pair. Both parameters are required; neither alone produces a valid answer.
      parameters:
      - name: from
        in: query
        required: true
        description: Origin. Uppercase IATA city code, e.g. PAR. A city slug such as paris also resolves.
        schema:
          type: string
          examples:
          - PAR
      - name: to
        in: query
        required: true
        description: Destination. Uppercase IATA city code, e.g. BKK. Must differ from from.
        schema:
          type: string
          examples:
          - BKK
      responses:
        '200':
          description: Fare record
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Fare'
        '400':
          description: Missing from or to
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Err'
        '404':
          description: no_data, unknown_origin, unknown_destination or same_city
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Err'
      tags:
      - Fare
components:
  schemas:
    Err:
      type: object
      properties:
        error:
          type: string
        from:
          type: string
        to:
          type: string
        hint:
          type: string
    Fare:
      type: object
      required:
      - from
      - to
      - price
      - currency
      - freshness
      properties:
        from:
          type: string
          description: Origin IATA city code
        to:
          type: string
          description: Destination IATA city code
        from_name:
          type: string
        to_name:
          type: string
        from_country:
          type: string
        to_country:
          type: string
        price:
          type: number
          description: Lowest observed one-way fare, rounded
        currency:
          type: string
          description: ISO 4217
        six_month_low:
          type:
          - number
          - 'null'
          description: Lowest fare observed in the trailing six months. null means not observed.
        best_depart_date:
          type:
          - string
          - 'null'
          description: Departure date on which the lowest fare was observed
        drop_pct:
          type: number
          description: Percent below the route baseline. 0 when unknown.
        freshness:
          type: string
          enum:
          - cached_snapshot
          description: Always cached_snapshot. Never real-time.
        html_url:
          type: string
        md_url:
          type: string
        live_check_url:
          type: string
          description: Send the user here before booking
        license:
          type: string
        cite_as:
          type: string
externalDocs:
  description: Full brief for AI systems
  url: https://aplusz.app/llms-full.txt
x-mcp-server:
  url: https://aplusz.app/mcp
  transport: streamable-http