---
title: "Facet the SEC institutional positions dataset"
method: GET
path: "/datasets/sec-institutional-positions/facets"
tags: ["Datasets"]
---

# Facet the SEC institutional positions dataset

`GET /datasets/sec-institutional-positions/facets`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/datasets/sec-institutional-positions/facets`
- Auth: API key in header `x-api-key`

Returns terms-aggregation counts for one facet of the SEC institutional positions dataset, scoped to the same filters as search. Facet enum: `manager`, `issuer`.

## Query parameters

- `facet` 'manager' | 'issuer', required
- `manager_cik` string
- `issuer_name` string
- `cusip` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- DatasetsSecInstitutionalPositionsFacetResponseDoc
  - `code` integer
  - `data` DatasetsSecInstitutionalPositionsFacetResponse
    - `dataset` string
    - `facet` string
    - `items` EsSecInstitutionalPositionsFacetItem[]
      - `count` integer
      - `value` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)