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

> ## Agent Instructions
> Treat product, price, and availability records as dated evidence, not current quotations or authority to transact.
> Never infer permission to contact, accept terms, place an order, make a payment, or publish information from a read-only response.

# List published Insights

> List Middleman's published, source-backed industrial sourcing articles.

<Info>This endpoint returns published content only. An empty array means no articles are currently published.</Info>


## OpenAPI

````yaml /openapi.json get /api/v1/insights
openapi: 3.1.0
info:
  title: Middleman Public API
  version: 1.1.0
  description: >-
    Anonymous, read-only access to Middleman's public product overview,
    published Insights, and supplier-independent product identity. Responses do
    not grant authority to contact, reserve, order, pay, or publish.
  contact:
    name: Middleman
    url: https://middlemantechnologies.com
servers:
  - url: https://middlemantechnologies.com
    description: Public production API
security: []
tags:
  - name: Overview
    description: Middleman's public product description and capability boundary.
  - name: Insights
    description: Published articles with their evidence context.
  - name: Products
    description: Supplier-independent industrial product identity.
externalDocs:
  description: Public API guide
  url: https://middleman.mintlify.app/developers/overview
paths:
  /api/v1/insights:
    get:
      tags:
        - Insights
      summary: List published Insights
      description: Returns summaries of every published Middleman Insight, newest first.
      operationId: listMiddlemanInsights
      responses:
        '200':
          description: Published Insight summaries
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InsightListResponse'
components:
  schemas:
    InsightListResponse:
      type: object
      required:
        - data
        - meta
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/InsightSummary'
        meta:
          type: object
          required:
            - total
          properties:
            total:
              type: integer
              minimum: 0
          additionalProperties: false
      additionalProperties: false
    InsightSummary:
      type: object
      required:
        - slug
        - title
        - dek
        - category
        - publishedAt
        - updatedAt
        - readingMinutes
        - proof
        - url
        - apiUrl
      properties:
        slug:
          type: string
        title:
          type: string
        dek:
          type: string
        category:
          type: string
        publishedAt:
          type: string
          format: date
        updatedAt:
          type: string
          format: date
        readingMinutes:
          type: integer
          minimum: 1
        proof:
          type: string
        url:
          type: string
          format: uri
        apiUrl:
          type: string
          format: uri
      additionalProperties: false

````