---
updatedAt: 2026-06-01T10:34:15.000Z
agentTools:
  projectIndex: https://docs.ortex.com/llms.txt
---

# Stock Reports — list

Paginated feed of premium weekly per-company Stock Reports. API subscribers receive the full body.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "ENTERPRISE APIs",
    "version": "1.0",
    "description": "A revolutionary global equity analytics platform which identifies and analyses relevant data for your stocks."
  },
  "paths": {
    "/api/v1/market_intelligence/stock_reports/": {
      "get": {
        "operationId": "market_intelligence_stock_reports_list",
        "description": "Paginated feed of premium weekly per-company Stock Reports. API subscribers receive the full body.",
        "summary": "Stock Reports — list",
        "parameters": [
          {
            "name": "page",
            "required": false,
            "in": "query",
            "description": "A page number within the paginated result set.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "required": false,
            "in": "query",
            "description": "Number of results to return per page.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "in": "query",
            "name": "ticker",
            "schema": {
              "type": "string"
            },
            "description": "Filter to a single ticker. Accepts BOTH `EXCHANGE:TICKER` (e.g. `NYSE:F`, `XNYS:F`, `US:F`) and legacy bare-ticker form with a separate `exchange` param. Searches both the row's primary tagged ticker AND every body-mentioned ticker, so `?ticker=NYSE:F` returns any article that references Ford anywhere — not just rows whose primary subject is Ford. Case-insensitive."
          }
        ],
        "tags": [
          "Market Intelligence"
        ],
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedStockReportCustomerListList"
                }
              }
            },
            "description": ""
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "PaginatedStockReportCustomerListList": {
        "type": "object",
        "required": [
          "length",
          "paginationLinks",
          "rows"
        ],
        "properties": {
          "paginationLinks": {
            "type": "object",
            "example": {
              "next": "http://api.example.org/accounts/?page=4",
              "previous": "http://api.example.org/accounts/?page=2"
            }
          },
          "length": {
            "type": "integer",
            "example": 123
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/StockReportCustomerList"
            }
          }
        }
      },
      "StockReportCustomerList": {
        "type": "object",
        "description": "Customer-API Stock Report list serializer.",
        "properties": {
          "id": {
            "type": "integer",
            "readOnly": true
          },
          "ticker": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "exchange": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "isin": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "ortexSid": {
            "type": "integer",
            "nullable": true,
            "readOnly": true
          },
          "companyName": {
            "type": "string",
            "nullable": true,
            "readOnly": true
          },
          "headline": {
            "type": "string",
            "maxLength": 500
          },
          "summary": {
            "type": "string",
            "description": "Short executive summary, ~2-3 sentences. Surfaced on list endpoints + ortex.news teaser."
          },
          "body": {
            "type": "string",
            "description": "Short body preview on list rows.\n\nLocked rows used to return ``''`` — now return a strict\n~100-char teaser so the public ortex.news surface has\nsomething to render and search-engines / readers see the\nopening of the article. The cap (``STOCK_REPORT_LOCKED_PREVIEW_CHARS``)\nis enforced server-side so a caller can never extract more\nthan the teaser by introspecting the wire.",
            "readOnly": true
          },
          "version": {
            "type": "integer",
            "maximum": 2147483647,
            "minimum": 0
          },
          "publishedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "provenance": {
            "type": "object",
            "additionalProperties": {},
            "readOnly": true
          },
          "identifiers": {
            "type": "array",
            "items": {
              "type": "object",
              "additionalProperties": {}
            },
            "description": "Per-report identifier list.\n\nStock Reports are by definition single-company deep-dives, so\nthe list has at most one entry — the primary trading item\nrendered with ``exchange`` / ``ticker`` / ``mic`` / ``isin``. Kept as\na list (rather than a flat object) for shape parity with the\nMIContent ``identifiers`` field so callers can iterate one\ncontract across both row types.",
            "readOnly": true
          }
        },
        "required": [
          "body",
          "companyName",
          "exchange",
          "headline",
          "id",
          "identifiers",
          "isin",
          "ortexSid",
          "provenance",
          "ticker"
        ]
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Ortex-Api-Key",
        "description": "Use test API key: `TEST` to get a limited result."
      }
    }
  },
  "servers": [
    {
      "url": "https://api.ortex.com/",
      "description": "Production"
    }
  ]
}
```