---
title: "GET /ratings/core"
method: GET
path: "/ratings/core"
tags: ["ratings"]
---

# GET /ratings/core

`GET /ratings/core`

Returns Context & Opponent-Relative Efficiency (CORE) ratings.
At least one of `year` or `team` is required.

## Query parameters

- `year` integer
- `team` string
- `conference` string

## Response `200`

Ok

- TeamCoreRating[]
  - `year` integer, required
  - `throughSeasonType` 'regular' | 'postseason', required
  - `throughWeek` integer, required
  - `team` string, required
  - `conference` string, nullable, required
  - `overall` number, double, required — Offense-minus-defense composite; higher is better.
  - `offense` number, double, required — Points created above average per 100 qualifying plays; higher is better.
  - `defense` number, double, required — Points allowed above average per 100 qualifying plays; lower is better.
  - `offensePlays` integer, required
  - `defensePlays` integer, required
  - `modelVersion` string, required

## Changes

- **2026-08-08** `cd2844c1ac5c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/changes/ratings/core/get.md)

---

[API](https://skmtc.dev/collegefootballdata/apis/college-football-data-api.md) · [All operations](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/collegefootballdata/apis/college-football-data-api/revisions/2753e757620d?raw)