---
title: "List Key Dates"
method: GET
path: "/internal/config/keydates"
tags: ["internal", "internal-config"]
---

# List Key Dates

`GET /internal/config/keydates`

## Request

- Base URL: `https://api.kobaltlabs.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kobaltlabs.com/internal/config/keydates`
- Auth: none declared

## Query parameters

- `namespace` string, uuid, required

## Response `200`

Successful Response

- KeyDateResourceResponse[]
  - `api_version` 'config.kobalt/v1'
  - `kind` 'KeyDate'
  - `metadata` ResourceMetadataWithAnnotations, required: Response-only metadata that also carries server-derived annotations.
    - `name` string, required
    - `namespace` string, uuid, required
    - `uid` string, uuid, nullable
    - `annotations` object
  - `spec` KeyDateSpec, required: Editable date fields; provenance and lifecycle are response annotations.
    - `vendor` ServiceVendorRef, required: Identifies a vendor by one or more of: name, company_website, company_uuid. All provided fields are stored and used for lookup in order of precedence: ``company_uuid`` → ``company_website`` → ``name``. At least one must be supplied.
      - `name` string, nullable
      - `company_website` string, nullable
      - `company_uuid` string, uuid, nullable
    - `key_date_type` 'termination_notice' | 'renewal' | 'review' | 'other', required
    - `month` integer, required
    - `day` integer, required
    - `first_year` integer, required
    - `interval_years` integer, nullable
    - `active` boolean, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-08** `9fe2fb8a3631`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/changes/internal/config/keydates/get.md)

---

[API](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api.md) - [All operations](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kobaltlabs/apis/kobaltlabs-api/revisions/8587332d5e43?raw)