---
title: "Get weekly summary email settings for a company"
method: GET
path: "/companies/{companyId}/weekly-email/settings"
tags: ["Company Settings"]
---

# Get weekly summary email settings for a company

`GET /companies/{companyId}/weekly-email/settings`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/weekly-email/settings`
- Auth: HTTP bearer

Demo-parity read for an explicitly allowlisted active or test company.

## Response `200`

Current weekly-email settings (returns defaults if not set)

- WeeklyEmailSettingsResponse
  - `data` WeeklyEmailSettings
    - `companyId` string, uuid, required
    - `enabled` boolean, required
    - `cadence` 'weekly', required
    - `sendDay` 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday', required
    - `sendTime` string, required: HH:MM 24-hour local clock time in `timezone`
    - `timezone` string, required: IANA time zone the send day and time are read in (#2656). Defaults to America/New_York.
    - `businessModel` 'software' | 'services' | 'digital', required: Effective copy variant, mapped from the company's stored business model (#1967). The per-settings value is used only when the company model cannot be read or is unset.
    - `intro` string, nullable
    - `enabledSections` string[], required
    - `updatedAt` string, date-time

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)