IVANS

IVANS Auto Service API

The Auto Service API from IVANS — 4 operation(s) for auto service.

GitHub OpenAPI

Operations 4

GET /api/v1/auto/details Get Vehicle Data with VIN or Year, Make, Model or a combination of these #
GET /api/v1/auto/makes Get unique vehicle makes #
GET /api/v1/auto/models Get unique vehicle models #
GET /api/v1/auto/years Get unique vehicle years #

Documentation

📖
APIReference
https://api.ivans.com/reference/agencies_list
📖
APIReference
https://api.ivans.com/reference/auth0_token_api_v1_identity_auth0_token__post
📖
APIReference
https://api.ivans.com/reference/get_basic_appetite_api_v1_forms_basic_appetite_get
📖
APIReference
https://api.ivans.com/reference/get_api-agencies-1
📖
APIReference
https://api.ivans.com/reference/get_api-v2-files
📖
APIReference
https://api.ivans.com/reference/get_api-v3-files
📖
APIReference
https://api.ivans.com/reference/getdocumentmetainfo
📖
APIReference
https://api.ivans.com/reference/task_status_api_v1_looker_task_status_post
📖
APIReference
https://api.ivans.com/reference/token

Specifications

⚙
OpenAPI
https://artifacts.apis.io/ivans/openapi/ivans-auto-service-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-risk-profile-read-only-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-insurance-license-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-enhanced-appetite-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-agent-detail-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-basic-appetite-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-agent-write-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-body-auth0-token-api-v1-identity-auth0-token-post-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-fast-path-submission-request-payload-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-risk-profile-diff-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-submission-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-auto-field-options-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-classic-quote-payload-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-submission-request-payload-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-file-content-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-bookroll-request-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-agency-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-consumer-info-registration-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-connection-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-file-metadata-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-file-with-content-type-and-status-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-producer-update-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-partner-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-carrier-naic-group-v2-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-file-paginated-filtered-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-record-count-result-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-claims-download-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-edoc-req-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-document-store-req-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-document-meta-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-edoc-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/ivans/json-schema/ivans-csv-response-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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/ivans:ivans-auto-service-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

ivans-auto-service-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Ivans Distribution Platform Auto Service API
  description: APIs for serving carrier forms, appetite, and validation
  version: 0.1.0
tags:
- name: Auto Service
paths:
  /api/v1/auto/details:
    get:
      tags:
      - Auto Service
      summary: Get Vehicle Data with VIN or Year, Make, Model or a combination of these
      description: Retrieve vehicle details by VIN or by year, make, and model.
      operationId: get_auto_details_api_v1_auto_details_get
      security:
      - HTTPBearer: []
      parameters:
      - name: vin
        in: query
        required: false
        schema:
          type: string
          description: Full VIN
          examples:
          - 1HGCM82633A123456
          title: Vin
        description: Full VIN
      - name: year
        in: query
        required: false
        schema:
          type: integer
          description: Model year filter
          examples:
          - 2003
          title: Year
        description: Model year filter
      - name: make
        in: query
        required: false
        schema:
          type: string
          description: Make
          examples:
          - HONDA
          title: Make
        description: Make
      - name: model
        in: query
        required: false
        schema:
          type: string
          description: Model
          examples:
          - ACCORD
          title: Model
        description: Model
      responses:
        '200':
          description: Successful retrieval of vehicle details
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/AutoDetailResponse'
                title: Response 200 Get Auto Details Api V1 Auto Details Get
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithValidationDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
        '404':
          description: VIN not found.
          content:
            application/json:
              example:
                detail: VIN not found. Please check your VIN and try again.
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithValidationDetails'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
  /api/v1/auto/makes:
    get:
      tags:
      - Auto Service
      summary: Get unique vehicle makes
      description: Retrieve unique make names for all vehicles listed alphabetically.
      operationId: get_makes_api_v1_auto_makes_get
      security:
      - HTTPBearer: []
      parameters:
      - name: year
        in: query
        required: true
        schema:
          type: integer
          title: Year
      - name: vehicle_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'Restrict to specified types: ''Vehicle'', ''Trailer''. Multiple types can be provided separated by commas.'
          title: Vehicle Type
        description: 'Restrict to specified types: ''Vehicle'', ''Trailer''. Multiple types can be provided separated by commas.'
      responses:
        '200':
          description: Successful retrieval of vehicle makes
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AutoFieldOptionsResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithValidationDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithValidationDetails'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
  /api/v1/auto/models:
    get:
      tags:
      - Auto Service
      summary: Get unique vehicle models
      description: Retrieve unique model names for all vehicles listed alphabetically.
      operationId: get_models_api_v1_auto_models_get
      security:
      - HTTPBearer: []
      parameters:
      - name: year
        in: query
        required: false
        schema:
          type: integer
          description: Model year filter
          examples:
          - 2020
          required: true
          title: Year
        description: Model year filter
      - name: make
        in: query
        required: false
        schema:
          type: string
          description: Make name filter (case insensitive)
          examples:
          - Toyota
          required: true
          title: Make
        description: Make name filter (case insensitive)
      responses:
        '200':
          description: Successful retrieval of vehicle models
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AutoFieldOptionsResponse'
                type: array
                items:
                  type: string
                title: Response 200 Get Models Api V1 Auto Models Get
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithValidationDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithValidationDetails'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
  /api/v1/auto/years:
    get:
      tags:
      - Auto Service
      summary: Get unique vehicle years
      description: Retrieve unique model years for all vehicles in descending order.
      operationId: get_years_api_v1_auto_years_get
      responses:
        '200':
          description: Successful retrieval of vehicle years
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AutoDetailResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithValidationDetails'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponseWithMessageOnly'
      security:
      - HTTPBearer: []
components:
  schemas:
    ValueOptionResponse:
      properties:
        label:
          type: string
          title: Label
          description: Label of the option
        value:
          anyOf:
          - type: integer
          - type: string
          title: Value
          description: Value of the option
      type: object
      required:
      - label
      - value
      title: ValueOptionResponse
      description: Response model for options with label and value.
    ValidationErrorDetail:
      properties:
        type:
          type: string
          title: Type
        loc:
          items:
            type: string
          type: array
          title: Loc
        msg:
          anyOf:
          - type: string
          - type: 'null'
          title: Msg
        input:
          title: Input
      type: object
      required:
      - type
      - loc
      - input
      title: ValidationErrorDetail
      description: Validation error detail for standard Pydantic/FastAPI request validation errors.
    AutoFieldValueResponse:
      properties:
        guid:
          type: string
          title: Guid
          description: GUID of the vehicle attribute
        label:
          type: string
          title: Label
          description: Label of the vehicle attribute
        value:
          anyOf:
          - type: integer
          - type: string
          - type: 'null'
          title: Value
          description: Value of the vehicle attribute
      type: object
      required:
      - guid
      - label
      title: AutoFieldValueResponse
      description: Response model for Auto field data with values.
    ErrorResponseWithMessageOnly:
      properties:
        detail:
          type: string
          title: Detail
      type: object
      required:
      - detail
      title: ErrorResponseWithMessageOnly
      description: Response for errors that have only a message.
    ErrorResponseWithValidationDetails:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationErrorDetail'
          type: array
          title: Detail
      type: object
      required:
      - detail
      title: ErrorResponseWithValidationDetails
      description: Response for errors that have a list of validation details.
    AutoDetailResponse:
      properties:
        details:
          items:
            anyOf:
            - $ref: '#/components/schemas/AutoFieldValueResponse'
            - $ref: '#/components/schemas/AutoFieldOptionsResponse'
          type: array
          title: Details
          description: List of vehicle details with labels and values
      type: object
      required:
      - details
      title: AutoDetailResponse
      description: Response model for Auto vehicle details.
    AutoFieldOptionsResponse:
      properties:
        guid:
          type: string
          title: Guid
          description: GUID of the vehicle attribute
        label:
          type: string
          title: Label
          description: Label of the vehicle attribute
        options:
          items:
            anyOf:
            - $ref: '#/components/schemas/ValueOptionResponse'
            - type: 'null'
          type: array
          title: Options
          description: List of unique vehicle attributes with labels and values
      type: object
      required:
      - guid
      - label
      - options
      title: AutoFieldOptionsResponse
      description: Response model for Auto field data with options.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
x-provenance:
  method: searched
  source: https://api.ivans.com/reference/get_basic_appetite_api_v1_forms_basic_appetite_get
  generated: '2026-10-13'
  note: Assembled verbatim from the OpenAPI definition fragments IVANS embeds in each operation page of its ReadMe developer portal (api.ivans.com/reference); paths and components merged per API, nothing authored.