openapi: 3.0.3
info:
  title: Basetrip Cities Cost API
  description: The Basetrip API provides travel intelligence data including country and city information, travel phrases, safety ratings, visa requirements, cost of living data, and health advisories. Designed to help travel platforms differentiate their products and improve traveler experiences.
  version: 3.0.0
  contact:
    name: Basetrip Support
    url: https://www.thebasetrip.com/en/documentation/v3
  termsOfService: https://www.thebasetrip.com/en/terms
servers:
- url: https://api.thebasetrip.com/v3
  description: Basetrip API v3
security:
- ApiKeyAuth: []
tags:
- name: Cost
paths:
  /countries/{id}/cost:
    get:
      operationId: getCountryCost
      summary: Get Country Cost
      description: Get cost of living and travel budget estimates for a country.
      tags:
      - Cost
      parameters:
      - name: id
        in: path
        required: true
        description: Country slug or alpha-2 code
        schema:
          type: string
      responses:
        '200':
          description: Cost information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CostInfo'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  responses:
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
        statusCode:
          type: integer
    CostInfo:
      type: object
      properties:
        country:
          type: string
        currency:
          type: string
        budgetPerDay:
          type: number
          description: Budget traveler daily cost in USD
        midRangePerDay:
          type: number
          description: Mid-range daily cost in USD
        luxuryPerDay:
          type: number
          description: Luxury daily cost in USD
        categories:
          type: object
          properties:
            accommodation:
              type: number
            food:
              type: number
            transport:
              type: number
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key