> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truckaurbus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# One launch by its id: its builds, the price from, the figures and what changed against the model it replaces or sits beside



## OpenAPI

````yaml /api-reference/openapi.json get /v1/launches/{launch_id}
openapi: 3.1.0
info:
  title: Truckaurbus API
  version: v1
  description: >-
    The public v1 API at https://api.truckaurbus.com/v1. Authenticate with an
    API key in the Authorization header: Bearer tab_live_...


    Register calls draw from prepaid credit: through a business key each call
    takes its price from the business's prepaid balance or trial credit, plus
    GST (standard ₹5, heavier ₹15, premium ₹25 at the list, down to ₹3, ₹9 and
    ₹15 with larger top-ups); a call that finds nothing is free, your own data
    and the calls that bring work cost nothing within their caps, and calls stop
    at zero with nothing owed. Paying by the call opens at launch. Prices and
    limits: https://docs.truckaurbus.com/limits


    Every figure carries its kind and its date. The API never carries the page a
    value came from.
servers:
  - url: https://api.truckaurbus.com
security: []
paths:
  /v1/launches/{launch_id}:
    get:
      tags:
        - v1
      summary: >-
        One launch by its id: its builds, the price from, the figures and what
        changed against the model it replaces or sits beside
      operationId: identity_api_v1_launch
      parameters:
        - in: path
          name: launch_id
          required: true
          schema:
            title: Launch Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LaunchOut'
          description: OK
components:
  schemas:
    LaunchOut:
      properties:
        builds:
          title: Builds
          type: integer
        changed:
          anyOf:
            - $ref: '#/components/schemas/ChangedOut'
            - type: 'null'
        class_key:
          title: Class Key
          type: string
        class_label:
          title: Class Label
          type: string
        electric:
          title: Electric
          type: boolean
        figures:
          items:
            $ref: '#/components/schemas/FigureOut'
          title: Figures
          type: array
        first_from_maker:
          title: First From Maker
          type: boolean
        fuels:
          items:
            type: string
          title: Fuels
          type: array
        id:
          title: Id
          type: string
        image:
          anyOf:
            - type: string
            - type: 'null'
          title: Image
        is_range:
          title: Is Range
          type: boolean
        kind:
          enum:
            - vehicle
            - machine
            - farm
          title: Kind
          type: string
        launched_on:
          title: Launched On
          type: string
        maker:
          $ref: '#/components/schemas/MakerRef'
        name:
          title: Name
          type: string
        new_to_range:
          title: New To Range
          type: boolean
        path:
          title: Path
          type: string
        price_from:
          anyOf:
            - $ref: '#/components/schemas/PriceFromOut'
            - type: 'null'
        rows:
          anyOf:
            - items:
                $ref: '#/components/schemas/BuildOut'
              type: array
            - type: 'null'
          title: Rows
      required:
        - id
        - kind
        - launched_on
        - maker
        - name
        - is_range
        - builds
        - class_key
        - class_label
        - fuels
        - electric
        - figures
        - new_to_range
        - first_from_maker
        - path
      title: LaunchOut
      type: object
    ChangedOut:
      properties:
        against:
          $ref: '#/components/schemas/AgainstOut'
        build:
          title: Build
          type: string
        relation:
          enum:
            - replaces
            - beside
          title: Relation
          type: string
        rows:
          items:
            $ref: '#/components/schemas/DeltaRowOut'
          title: Rows
          type: array
      required:
        - relation
        - build
        - against
        - rows
      title: ChangedOut
      type: object
    FigureOut:
      properties:
        high:
          anyOf:
            - type: number
            - type: integer
            - type: 'null'
          title: High
        key:
          title: Key
          type: string
        label:
          title: Label
          type: string
        unit:
          title: Unit
          type: string
        value:
          anyOf:
            - type: number
            - type: integer
          title: Value
      required:
        - key
        - label
        - unit
        - value
      title: FigureOut
      type: object
    MakerRef:
      properties:
        name:
          title: Name
          type: string
        slug:
          title: Slug
          type: string
      required:
        - slug
        - name
      title: MakerRef
      type: object
    PriceFromOut:
      properties:
        as_of:
          title: As Of
          type: string
        high_inr:
          anyOf:
            - type: integer
            - type: 'null'
          title: High Inr
        inr:
          title: Inr
          type: integer
        kind:
          title: Kind
          type: string
      required:
        - inr
        - kind
        - as_of
      title: PriceFromOut
      type: object
    BuildOut:
      properties:
        entity:
          title: Entity
          type: string
        fuel:
          anyOf:
            - type: string
            - type: 'null'
          title: Fuel
        lifecycle:
          title: Lifecycle
          type: string
        name:
          title: Name
          type: string
        path:
          title: Path
          type: string
        price_from_inr:
          anyOf:
            - type: integer
            - type: 'null'
          title: Price From Inr
        price_kind:
          anyOf:
            - type: string
            - type: 'null'
          title: Price Kind
        slug:
          title: Slug
          type: string
      required:
        - slug
        - name
        - entity
        - path
        - lifecycle
      title: BuildOut
      type: object
    AgainstOut:
      properties:
        lifecycle:
          title: Lifecycle
          type: string
        maker:
          title: Maker
          type: string
        name:
          title: Name
          type: string
        path:
          title: Path
          type: string
        slug:
          title: Slug
          type: string
      required:
        - slug
        - name
        - maker
        - lifecycle
        - path
      title: AgainstOut
      type: object
    DeltaRowOut:
      properties:
        change:
          anyOf:
            - type: number
            - type: integer
            - type: 'null'
          title: Change
        key:
          title: Key
          type: string
        label:
          title: Label
          type: string
        now:
          anyOf:
            - type: number
            - type: integer
            - type: string
          title: Now
        now_kind:
          anyOf:
            - type: string
            - type: 'null'
          title: Now Kind
        same:
          title: Same
          type: boolean
        unit:
          title: Unit
          type: string
        was:
          anyOf:
            - type: number
            - type: integer
            - type: string
          title: Was
        was_kind:
          anyOf:
            - type: string
            - type: 'null'
          title: Was Kind
      required:
        - key
        - label
        - unit
        - now
        - was
        - same
      title: DeltaRowOut
      type: object

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.