---
title: "Get one Culver's restaurant's flavor-of-the-day and daily soup schedule"
method: GET
path: "/culvers/calendar"
tags: ["Culvers"]
---

# Get one Culver's restaurant's flavor-of-the-day and daily soup schedule

`GET /culvers/calendar`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/culvers/calendar`
- Auth: API key in header `x-api-key`

Returns the full published schedule for one Culver's restaurant: the flavor of the day for every upcoming calendar date, plus the soups served on each date. Culver's publishes roughly a two-month forward window, and the schedule is genuinely per-restaurant -- two restaurants on the same date routinely feature different soups. slug comes from GET /culvers/directory. GET /culvers/store returns only today's and tomorrow's flavor; use this endpoint for the whole calendar.

## Query parameters

- `slug` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- CulversCalendarResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` CulversCalendarResponse
    - `end_date` string
    - `fetched_at` string
    - `flavor_count` integer: FlavorCount and SoupCount are the entry counts, not distinct-day counts -- several soups share one date.
    - `flavors` CulversCalendarFlavor[]
      - `date` string: Date is the calendar date (YYYY-MM-DD) this flavor is featured.
      - `description` string
      - `image_url` string
      - `menu_item_id` integer: MenuItemID matches the flavor's menu item. Culver's also publishes a separate `flavorId` on each calendar entry, but it is redundant -- across 214 entries sampled from 4 restaurants it was identical to menuItemId every time (2026-09-05) -- so it is not surfaced, keeping this DTO's id field consistent with CalendarSoup's.
      - `name` string
      - `slug` string
    - `name` string
    - `restaurant_id` integer
    - `slug` string
    - `soup_count` integer
    - `soups` CulversCalendarSoup[]
      - `date` string: Date is the calendar date (YYYY-MM-DD) this soup is served.
      - `description` string
      - `image_url` string
      - `menu_item_id` integer
      - `name` string
      - `slug` string
    - `source_url` string
    - `start_date` string: StartDate and EndDate bound the window Culver's currently publishes (roughly two months forward). Empty when the restaurant publishes no calendar at all.
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[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/afac9b012a27?raw)