---
title: "Get commercial schedules"
method: GET
path: "/api/v1/discovery/commercial-schedules/{id}"
tags: ["discovery"]
deprecated: true
---

# Get commercial schedules

`GET /api/v1/discovery/commercial-schedules/{id}`

## Request

- Base URL: `https://point11.ai`
- URL: `https://point11.ai/api/v1/discovery/commercial-schedules/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://auth.point11.ai/oauth2/authorize`, token URL `https://auth.point11.ai/oauth2/token`)

> **Deprecated.**

Deprecated: use business.commercial-schedules.get.v1 (business_commercial_schedules_get), which reads the same rules by the business profile every product's campaigns on it plan by. Read a Discovery campaign's calendar rules as saved now: its business profile's version, the weekly schedule of each product the company sells (revenueLines), and the zone the rules read in (the one their lines name, weighted by the campaign's customers). `id` is the campaign id; change the rules with business.commercial-schedules.update.

## Path parameters

- `id` string, uuid, required: Discovery campaign id.

## Headers

- `Point11-Organization` string, uuid

## Response `200`

Success.

- DiscoveryCommercialSchedulesGetResponse
  - `timeZone` string, nullable, required: The zone the campaign's rules read in: the one their lines name, weighted by the campaign's customers; null when no line names one.
  - `profile` object, nullable, required: The business profile whose rules these are; null for a campaign without one.
    - `profileId` string, uuid, required
    - `profileName` string, nullable, required
    - `profileVersionId` string, uuid, required: Pass as baseVersionId when updating the rules.
    - `profileVersion` integer, required
    - `generatedAt` string, date-time, required
  - `revenueLines` DiscoveryRevenueLinesItem[], required: Each product's rules: one per company revenue line.
    - `revenueLineId` string, uuid, required
    - `revenueLineName` string, required
    - `schedule` DiscoverySchedule, required
      - `valid_from` string, date
      - `valid_through` string, date
      - `date_overrides` object[]
        - `date` string, date, required
        - `weight_multiplier` number, required
        - `label` string, required
        - `basis` string, nullable, required
        - `evidence_refs` string[], required
      - `time_zone` string, nullable, required
      - `weekly_windows` object[], required
        - `days` string[], required
        - `start_hour_local` integer, required
        - `end_hour_local` integer, required
        - `relative_weight` number, required
        - `label` string, nullable, required
      - `annual_modifiers` object[], required
        - `start_month_day` string, required
        - `end_month_day` string, required
        - `weight_multiplier` number, required
        - `label` string, required
        - `basis` string, nullable, required
      - `exceptions` object[]
        - `start_date` string, date, required
        - `end_date` string, date, required
        - `weekly_windows` object[], required
          - `days` string[], required
          - `start_hour_local` integer, required
          - `end_hour_local` integer, required
          - `relative_weight` number, required
          - `label` string, nullable, required
        - `label` string, required
        - `basis` string, nullable, required
        - `evidence_refs` string[], required
      - `confidence` 'low' | 'medium' | 'high', required
      - `basis` string, required
      - `evidence_refs` string[], required
    - `scheduleStatus` 'profile' | 'missing' | 'invalid', required: `missing` and `invalid` lines have no usable schedule.
    - `scheduleRevision` object, nullable, required: Pass its id as expectedRevisionId when updating the line.
      - `id` string, uuid, required
      - `revision` integer, required
      - `reset` boolean, required: The revision returned the line to research's schedule.

## Other responses

- `400`: The input, query, or Idempotency-Key is invalid.
- `401`: The bearer is missing, expired, or not accepted.
- `403`: The credential lacks the operation's scope or role, or the operation needs a different door.
- `404`: The resource or organization does not exist for this caller.
- `405`: This path takes another HTTP method, named in `Allow`.
- `409`: The request conflicts with current state or with prior use of its Idempotency-Key.
- `413`: The request, or the answer it asks for, is too large; narrow it.
- `429`: The credential's rate budget is spent; retry after `Retry-After` seconds.
- `500`: An unexpected server failure; retry later. Only `request_id` identifies it.
- `503`: A dependency is temporarily unavailable; retry after `Retry-After` seconds.
- `default`: Another status a product answers for its own refusal (for example `415` for an unsupported attachment); branch on `code`.

---

[API](https://skmtc.dev/point11/apis/point11-api.md) · [All operations](https://skmtc.dev/point11/apis/point11-api/llms.txt) · [OpenAPI document](https://skmtc.dev/point11/apis/point11-api/revisions/36a84c7aca11?raw)