---
title: "List S&P 500 Company Constituents records"
method: GET
path: "/v1/data/s-p-500-company-constituents"
tags: ["Stock Market Indices"]
---

# List S&P 500 Company Constituents records

`GET /v1/data/s-p-500-company-constituents`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/data/s-p-500-company-constituents`
- Auth: none declared. Required headers: `X-API-Key`

List S&P 500 Company Constituents records with optional filters and pagination.

**Source:** S&P 500 constituents data from the datasets/s-and-p-500-companies project (github.com/datasets) (ODC-PDDL-1.0).

**Fields returned:**
- `symbol` (str) — Stock ticker symbol
- `security` (str) — Company name
- `gics_sector` (str) — Industry sector
- `gics_sub_industry` (str) — Industry sub-category
- `headquarters_location` (str) — City and state of company headquarters
- `date_added` (str) — Date the company joined the index
- `cik` (str) — SEC Central Index Key
- `founded` (str) — Year the company was founded

**Example:** `GET /v1/data/s-p-500-company-constituents?limit=10&gics_sector=example`

## Query parameters

- `limit` integer: Max records to return (1-100).
- `offset` integer: Records to skip, for pagination.
- `gics_sector` string, nullable: Industry sector
- `gics_sub_industry` string, nullable: Industry sub-category

## Headers

- `X-API-Key` string, required

## Response `200`

A page of S&P 500 Company Constituents records with pagination metadata.

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aristocles/apis/aristocles-data-api.md) · [All operations](https://skmtc.dev/aristocles/apis/aristocles-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aristocles/apis/aristocles-data-api/revisions/4ca3fbb73c59?raw)