openapi: 3.0.0
info:
  title: Uber for Business Codes Trips API
  description: The Uber for Business API enables organizations to automate workflows within their enterprise Uber accounts. Provides access to trip invoices, receipts, and business travel data for expense management and reporting.
  version: 1.2.0
  contact:
    name: Uber Developer Support
    url: https://developer.uber.com/support
servers:
- url: https://api.uber.com/v1.2
  description: Production
- url: https://sandbox-api.uber.com/v1.2
  description: Sandbox
security:
- BearerAuth: []
tags:
- name: Trips
  description: Business trip receipts and invoices
paths:
  /business/trips/{trip_id}/invoice_urls:
    get:
      operationId: getTripInvoiceUrls
      summary: Get Trip Invoice URLs
      description: Retrieve invoice URLs for a business trip.
      tags:
      - Trips
      parameters:
      - name: trip_id
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the business trip.
      responses:
        '200':
          description: Invoice URLs for the trip.
          content:
            application/json:
              schema:
                type: object
                properties:
                  invoice_urls:
                    type: array
                    items:
                      type: string
                      format: uri
                    description: List of invoice download URLs.
        '404':
          description: Trip not found.
  /business/trips/{trip_id}/receipt:
    get:
      operationId: getTripReceipt
      summary: Get Trip Receipt
      description: Fetch receipt details for a completed business trip.
      tags:
      - Trips
      parameters:
      - name: trip_id
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the business trip.
      responses:
        '200':
          description: Receipt details for the trip.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TripReceipt'
        '404':
          description: Trip not found.
  /business/trips/{trip_id}/receipt/pdf_url:
    get:
      operationId: getTripReceiptPdfUrl
      summary: Get Trip Receipt PDF URL
      description: Obtain a PDF download URL for a business trip receipt.
      tags:
      - Trips
      parameters:
      - name: trip_id
        in: path
        required: true
        schema:
          type: string
        description: Unique identifier for the business trip.
      responses:
        '200':
          description: PDF URL for the trip receipt.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pdf_url:
                    type: string
                    format: uri
                    description: URL to download the PDF receipt.
        '404':
          description: Trip not found.
components:
  schemas:
    TripReceipt:
      type: object
      properties:
        trip_id:
          type: string
          description: Unique trip identifier.
        business_name:
          type: string
          description: Name of the associated business account.
        employee_id:
          type: string
          description: Employee identifier for the trip.
        start_time:
          type: string
          format: date-time
          description: Trip start time.
        end_time:
          type: string
          format: date-time
          description: Trip end time.
        origin:
          type: object
          properties:
            address:
              type: string
            latitude:
              type: number
            longitude:
              type: number
        destination:
          type: object
          properties:
            address:
              type: string
            latitude:
              type: number
            longitude:
              type: number
        distance:
          type: number
          description: Trip distance in miles.
        duration:
          type: number
          description: Trip duration in seconds.
        charges:
          type: array
          items:
            type: object
            properties:
              name:
                type: string
              amount:
                type: number
              type:
                type: string
        total_charged:
          type: number
          description: Total amount charged in local currency.
        currency_code:
          type: string
          description: ISO 4217 currency code.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: OAuth 2.0 Bearer token with business.receipts scope