---
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

---

[API](https://skmtc.net/collegefootballdata/apis/college-football-data-api.md) · [All operations](https://skmtc.net/collegefootballdata/apis/college-football-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collegefootballdata/college-football-data-api/revisions/2753e757620d/schema)