IVANS Connections API

The Connections API from IVANS — 3 operation(s) for connections.

Operations 3

GET /api/Organizations/{accountCode}/Connections/{connectionKey} Retrieve connection information for a given organization and line of business #
GET /api/Organizations/{accountCode}/Connections Retrieve connection information for a given organization #
PUT /api/Connections/{connectionKey} Update connection information #

Documentation

Specifications

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-connections-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.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

ivans-connections-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: IVANS Exchange API Docs Connections API
  version: v1
tags:
- name: Connections
paths:
  /api/Organizations/{accountCode}/Connections/{connectionKey}:
    get:
      tags:
      - Connections
      summary: Retrieve connection information for a given organization and line of business
      description: Get connection information for a given organization partnership and line of business.
      parameters:
      - name: accountCode
        in: path
        description: The organization ID.
        required: true
        schema:
          type: string
      - name: connectionKey
        in: path
        description: The connection key.
        required: true
        schema:
          type: integer
          format: int32
      - name: api-version
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Successful operation.
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/Connection'
            application/json:
              schema:
                $ref: '#/components/schemas/Connection'
            text/json:
              schema:
                $ref: '#/components/schemas/Connection'
        '401':
          description: User not authorized to view this resource.
        '404':
          description: Connection with this ID was not found.
      operationId: getApiOrganizationsByAccountCodeConnectionsByConnectionKey
      x-operation-id-source: derived
  /api/Organizations/{accountCode}/Connections:
    get:
      tags:
      - Connections
      summary: Retrieve connection information for a given organization
      description: Get connection information for a given organization
      parameters:
      - name: accountCode
        in: path
        description: The organization ID.
        required: true
        schema:
          type: string
      - name: agencyId
        in: query
        description: Optional trading partner ID.
        schema:
          type: string
      - name: carrierId
        in: query
        description: Optional trading partner ID.
        schema:
          type: string
      - name: lobCode
        in: query
        description: Optional Line of Business code.
        schema:
          type: string
      - name: preferenceCode
        in: query
        description: Optional CSV list of Preference Codes.
        schema:
          type: string
      - name: feedbackCode
        in: query
        description: Optional CSV list of Feedback Codes.
        schema:
          type: string
      - name: api-version
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Successful operation.
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Connection'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Connection'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Connection'
        '401':
          description: User not authorized to view this resource.
      security:
      - Bearer: []
      operationId: getApiOrganizationsByAccountCodeConnections
      x-operation-id-source: derived
  /api/Connections/{connectionKey}:
    put:
      tags:
      - Connections
      summary: Update connection information
      description: 'Update connection information for a given connection ID. Updateable fields: PreferenceCode, FeedbackCode.


        Updateable fields: NewPreferenceCode, NewFeedbackCode.'
      parameters:
      - name: connectionKey
        in: path
        description: The connection key.
        required: true
        schema:
          type: integer
          format: int32
      - name: api-version
        in: query
        schema:
          type: string
      requestBody:
        description: Connection data to be updated.
        content:
          application/json-patch+json:
            schema:
              $ref: '#/components/schemas/ConnectionRequest'
          application/json:
            schema:
              $ref: '#/components/schemas/ConnectionRequest'
          text/json:
            schema:
              $ref: '#/components/schemas/ConnectionRequest'
          application/*+json:
            schema:
              $ref: '#/components/schemas/ConnectionRequest'
      responses:
        '200':
          description: Successful operation.
        '400':
          description: The request is not formatted properly.
        '401':
          description: User not authorized to view this resource.
        '404':
          description: Connection with this ID was not found.
      security:
      - Bearer: []
      operationId: putApiConnectionsByConnectionKey
      x-operation-id-source: derived
components:
  schemas:
    ConnectionRequest:
      required:
      - agencyAccount
      - carrierAccount
      type: object
      properties:
        agencyAccount:
          minLength: 1
          type: string
        carrierAccount:
          minLength: 1
          type: string
        preferenceCode:
          type:
          - string
          - 'null'
        feedbackCode:
          type:
          - string
          - 'null'
      additionalProperties: false
    Connection:
      required:
      - agencyAccount
      - agencyName
      - carrierAccount
      - carrierName
      - feedbackCode
      - feedbackDisplayValue
      - lob
      - lobDescription
      - preferenceCode
      - preferenceDisplayValue
      type: object
      properties:
        connectionKey:
          type: integer
          format: int32
        agencyAccount:
          type: string
        agencyName:
          type: string
        carrierAccount:
          type: string
        carrierName:
          type: string
        lob:
          type: string
        lobDescription:
          type: string
        active:
          type: boolean
        available:
          type: boolean
        preferenceCode:
          type: string
        preferenceDisplayValue:
          type: string
        preferenceUpdatedDate:
          type:
          - string
          - 'null'
          format: date-time
        feedbackCode:
          type: string
        feedbackDisplayValue:
          type: string
        feedbackUpdatedDate:
          type:
          - string
          - 'null'
          format: date-time
      additionalProperties: false
  securitySchemes:
    Bearer:
      type: http
      description: JWT
      scheme: Bearer
x-readme:
  explorer-enabled: true
  proxy-enabled: true
x-provenance:
  method: searched
  source: https://api.ivans.com/reference/get_api-agencies-1
  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.