openapi: 3.2.0
info:
  title: Automile Resource Owner Trip Merge V2 API
  version: v1
tags:
- name: ResourceOwnerTripMergeV2
paths:
  /v1/resourceowner/tripmerge:
    post:
      tags:
      - ResourceOwnerTripMergeV2
      summary: Merge trips
      description: Url is returned as location in header
      operationId: ResourceOwnerTripMergeController_MergeTrips
      responses:
        '200':
          description: Success
        '201':
          description: Trips successfully merged
        '403':
          description: Forbidden access to resource
        '500':
          description: Internal server error
      security:
      - oauth2: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TripMergeModelPOST'
          text/json:
            schema:
              $ref: '#/components/schemas/TripMergeModelPOST'
          application/*+json:
            schema:
              $ref: '#/components/schemas/TripMergeModelPOST'
        description: Model containing which and how trips should be mereged
  /v1/resourceowner/tripmerge/{tripId}/unmerge:
    put:
      tags:
      - ResourceOwnerTripMergeV2
      summary: Unmerge trips
      operationId: ResourceOwnerTripMergeController_UnmergeTrips
      parameters:
      - in: path
        name: tripId
        description: Trip id of merged trip
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: Success
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TripModel'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TripModel'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TripModel'
        '201':
          description: Trips successfully unmerged
        '403':
          description: Forbidden access to resource
        '500':
          description: Internal server error
      security:
      - oauth2: []
  /v1/resourceowner/tripmerge/{tripId}:
    get:
      tags:
      - ResourceOwnerTripMergeV2
      summary: Get all trips within a merged trip
      operationId: ResourceOwnerTripMergeController_GetTripList
      parameters:
      - in: path
        name: tripId
        description: Trip id on merged trip
        required: true
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: List containing all trips within the merged trip
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TripModel'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TripModel'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TripModel'
        '403':
          description: Forbidden access to resource
        '500':
          description: Internal server error
      security:
      - oauth2: []
components:
  schemas:
    TripMergeModelPOST:
      type: object
      properties:
        TripIdList:
          type: array
          items:
            format: int32
            type: integer
      additionalProperties: false
    TripModel:
      type: object
      properties:
        TripId:
          format: int32
          type: integer
        TripStartDateTime:
          format: date-time
          type: string
        TripEndDateTime:
          format: date-time
          type: string
        DistanceKilometers:
          format: double
          type: number
        FuelConsumptionInLiters:
          format: double
          type: number
        TripStartFormattedAddress:
          type: string
        TripEndFormattedAddress:
          type: string
        TripStartCustomAddress:
          type: string
        TripEndCustomAddress:
          type: string
        VehicleId:
          format: int32
          type: integer
        TripType:
          format: int32
          enum:
          - 0
          - 1
          - 2
          - 3
          type: integer
        DriverContactId:
          format: int32
          type: integer
        HasSpeedingViolation:
          type: boolean
        HasIdlingEvent:
          type: boolean
        HasAccelerationEvent:
          type: boolean
        HasAccident:
          type: boolean
        HasTurningEvent:
          type: boolean
        HasBrakingEvent:
          type: boolean
        ParkedForMinutesUntilNextTrip:
          format: int32
          type: integer
        HasDrivingEvents:
          type: boolean
        CustomCategory:
          type: string
        TripTags:
          type: string
        HideStartRoute:
          type: boolean
        HideEndRoute:
          type: boolean
        VehicleType:
          format: int32
          enum:
          - 0
          - 1
          - 2
          - 3
          - 4
          - 5
          - 6
          - 255
          type: integer
        TripApprovalStatus:
          format: int32
          enum:
          - 0
          - 1
          - 2
          - 3
          type: integer
        IsMerged:
          type: boolean
        HasGermanTaxRules:
          type: boolean
        IsLocked:
          type: boolean
        LockReason:
          format: int32
          enum:
          - 0
          - 1
          - 2
          - 4
          type: integer
        TripStartCountry:
          type: string
        TripStartPostalCode:
          type: string
        TripEndCountry:
          type: string
        TripEndPostalCode:
          type: string
      additionalProperties: false
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        implicit:
          scopes:
            read: Read access to protected resources
            write: Write access to protected resources
          authorizationUrl: https://api.automile.com/login/
      description: OAuth2 Implicit Grant
x-provenance:
  method: harvested
  publisher: Automileab
  source: https://api.automile.com/swagger/v1/swagger.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)