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/citedtravel-com:citedtravel-com-facts-api"

All apis

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

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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: CitedTravel Facts API
  version: 0.2.0
  summary: Agent-readable travel facts with citations, licenses, last_verified dates and confidence scores.
  description: 'Every fact carries `sources` (publisher, URL, license, verbatim quote or source value), `cross_checks`, `last_verified`, `next_review_due` and `confidence {score, level, reasons}`.


    **Languages:** pass `lang` (BCP 47) or `Accept-Language`. Supported: en, ja, zh-Hans, zh-Hant. Any field `x` with a sibling `x_i18n` is resolved to the requested language with English fallback, and `x_lang` says which was served. Verbatim official quotes are never translated; translations (none yet) would be separate and labelled unofficial.


    **Entry requirements** are a pilot (GB, US, JP passports) and decision support only: every answer has an `advisory`, `official_links` and `not_a_verdict`.


    **Access:** static categories work without a key (60 requests/min/IP). A free key (1,000 calls/month, 50 entry calls) is required for entry and trip briefs. Paid plans: Builder US$19/month and Pro US$99/month plus any tax, monthly subscriptions sold through Link (Stripe) as merchant of record, renewing until cancelled (`POST /v1/billing/checkout`; manage or cancel at https://citedtravel.com/account/ or `POST /v1/billing/portal`; paid plans aren''t available in every country, see https://citedtravel.com/terms/#6-subscriptions). Agents may instead pay per call with x402 v2 (`PAYMENT-SIGNATURE` header; USDC on Base mainnet; payments are final).


    **Disclaimer:** informational only; not legal or immigration advice. See https://citedtravel.com/disclaimer/.'
  termsOfService: https://citedtravel.com/terms/
  contact:
    name: CitedTravel
    url: https://citedtravel.com/support/
    email: support@citedtravel.com
  license:
    name: 'Data: per-fact source licenses (see attribution field)'
    url: https://citedtravel.com/docs/#licensing
  x-guidance: Without an API key, GET /v1/entry ($0.01) and GET /v1/trip-brief ($0.02) answer 402 with an x402 v2 PAYMENT-REQUIRED header (USDC). Retry with PAYMENT-SIGNATURE. Static fact routes are free without a key up to 60 requests/min/IP and cost $0.005 per call beyond that. Always show the advisory and official_links from entry answers; they are decision support, never a go/no-go verdict. Settled payments are final.
servers:
- url: https://citedtravel.com
security:
- {}
- bearer: []
- apiKey: []
tags:
- name: facts
paths:
  /v1/countries/{cc}:
    get:
      tags:
      - facts
      operationId: getCountry
      summary: 'All static facts for one country (holidays: current year)'
      parameters:
      - name: cc
        in: path
        required: true
        schema:
          type: string
          pattern: ^[A-Za-z]{2,3}$
        description: ISO 3166-1 alpha-2 or alpha-3 code
      - name: categories
        in: query
        required: false
        schema:
          type: string
        description: Comma-separated subset
      - $ref: '#/components/parameters/lang'
      responses:
        '200':
          description: Country bundle
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
            Content-Language:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Problem'
        '401':
          $ref: '#/components/responses/Problem'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '404':
          $ref: '#/components/responses/Problem'
        '429':
          $ref: '#/components/responses/Problem'
      x-x402-price-usd: 0.005
      x-x402-network: eip155:8453 (Base mainnet, USDC)
  /v1/countries/{cc}/{category}:
    get:
      tags:
      - facts
      operationId: getCountryCategory
      summary: Facts for one category
      parameters:
      - name: cc
        in: path
        required: true
        schema:
          type: string
          pattern: ^[A-Za-z]{2,3}$
        description: ISO 3166-1 alpha-2 or alpha-3 code
      - name: category
        in: path
        required: true
        schema:
          enum:
          - power
          - currency
          - emergency
          - driving
          - holidays
          - tipping
      - name: from
        in: query
        required: false
        schema:
          type: string
          format: date
        description: 'holidays only: start date'
      - name: to
        in: query
        required: false
        schema:
          type: string
          format: date
        description: 'holidays only: end date'
      - $ref: '#/components/parameters/lang'
      responses:
        '200':
          description: Category facts
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
            Content-Language:
              schema:
                type: string
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CategoryResponse'
        '400':
          $ref: '#/components/responses/Problem'
        '401':
          $ref: '#/components/responses/Problem'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '404':
          $ref: '#/components/responses/Problem'
        '429':
          $ref: '#/components/responses/Problem'
      x-x402-price-usd: 0.005
      x-x402-network: eip155:8453 (Base mainnet, USDC)
  /v1/power/compat:
    get:
      tags:
      - facts
      operationId: powerCompat
      summary: Adapter / converter verdict (computed)
      parameters:
      - name: from
        in: query
        required: true
        schema:
          type: string
        description: Home country
      - name: to
        in: query
        required: true
        schema:
          type: string
        description: Destination
      - $ref: '#/components/parameters/lang'
      responses:
        '200':
          description: Verdict
          headers:
            RateLimit-Limit:
              $ref: '#/components/headers/RateLimit-Limit'
            RateLimit-Remaining:
              $ref: '#/components/headers/RateLimit-Remaining'
            RateLimit-Reset:
              $ref: '#/components/headers/RateLimit-Reset'
            Content-Language:
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
        '400':
          $ref: '#/components/responses/Problem'
        '401':
          $ref: '#/components/responses/Problem'
        '402':
          $ref: '#/components/responses/PaymentRequired'
        '404':
          $ref: '#/components/responses/Problem'
        '429':
          $ref: '#/components/responses/Problem'
      x-x402-price-usd: 0.005
      x-x402-network: eip155:8453 (Base mainnet, USDC)
components:
  parameters:
    lang:
      name: lang
      in: query
      schema:
        type: string
        examples:
        - en
        - ja
        - zh-Hans
        - zh-Hant
        - zh-TW
      description: BCP 47 language tag; falls back to English.
  schemas:
    Confidence:
      type: object
      required:
      - score
      - level
      - reasons
      properties:
        score:
          type: number
          minimum: 0
          maximum: 1
        level:
          enum:
          - high
          - medium
          - low
        reasons:
          type: array
          items:
            type: string
    Fact:
      type: object
      required:
      - id
      - country
      - category
      - field
      - value
      - sources
      - last_verified
      - confidence
      properties:
        id:
          type: string
        country:
          type: string
        category:
          type: string
        field:
          type: string
        value: {}
        sources:
          type: array
          items:
            $ref: '#/components/schemas/Source'
        cross_checks:
          type: array
          items:
            type: object
        last_verified:
          type: string
          format: date
        next_review_due:
          type: string
          format: date
        confidence:
          $ref: '#/components/schemas/Confidence'
        attribution:
          type: array
          items:
            type: string
        localization:
          type: object
    Problem:
      type: object
      required:
      - type
      - title
      - status
      properties:
        type:
          type: string
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
    Source:
      type: object
      required:
      - source_id
      - publisher
      - url
      - license
      - retrieved_at
      properties:
        source_id:
          type: string
        publisher:
          type: string
        url:
          type: string
          format: uri
        license:
          type: string
        retrieved_at:
          type: string
        quote:
          type: string
        quote_language:
          type: string
        source_value: {}
    CategoryResponse:
      type: object
      properties:
        country:
          type: object
        category:
          type: string
        dataset_version:
          type: string
        data:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/Fact'
        attribution:
          type: array
          items:
            type: string
        disclaimer:
          type: string
  headers:
    RateLimit-Reset:
      schema:
        type: integer
      description: Seconds until reset
    RateLimit-Remaining:
      schema:
        type: integer
    RateLimit-Limit:
      schema:
        type: integer
  responses:
    PaymentRequired:
      description: 'x402 v2: payment required (PAYMENT-REQUIRED header, base64 JSON)'
      headers:
        PAYMENT-REQUIRED:
          schema:
            type: string
      content:
        application/json:
          schema:
            type: object
    Problem:
      description: RFC 9457 problem
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: 'API key: ct_live_… / ct_test_…'
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
    x402:
      type: apiKey
      in: header
      name: PAYMENT-SIGNATURE
      description: x402 v2 payment payload (base64 JSON). See the PAYMENT-REQUIRED header of a 402 response.