---
title: "Proposal detail including its decision timeline"
method: GET
path: "/accountant/companies/{customerId}/schedule-proposals/{id}"
tags: ["Accountant Portal", "Schedule Proposals"]
---

# Proposal detail including its decision timeline

`GET /accountant/companies/{customerId}/schedule-proposals/{id}`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/accountant/companies/{customerId}/schedule-proposals/{id}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Response `200`

Proposal detail + timeline

- ScheduleProposalDetailResponse
  - `success` boolean
  - `data` object: One AI-detected deferral/accrual candidate with its derived schedule inputs and confidence. Never a book write on its own; materialization (#1266 Phase B) turns approved proposals into schedule definitions.
    - `id` string, uuid
    - `companyId` string, uuid
    - `entityId` string, uuid, nullable
    - `currency` string, nullable
    - `proposalType` 'deferral' | 'accrual'
    - `kind` 'prepaid_amortization' | 'deferred_revenue_recognition' | 'accrual'
    - `derivedInputs` object: Zod-validated derived inputs (per-type schema; legs are ScheduleProposalLeg items).
    - `totalAmountCents` integer
    - `startDate` string, date
    - `endDate` string, date, nullable
    - `confidencePct` number
    - `confidenceBand` 'high' | 'medium' | 'low'
    - `confidenceComponents` object
    - `detectionSignals` object
    - `reasoning` string, nullable
    - `sourceKind` string
    - `sourceId` string, nullable
    - `dedupKey` string
    - `inputHash` string
    - `matchKey` string, nullable
    - `status` 'proposed' | 'pending_review' | 'approved' | 'rejected' | 'blocked' | 'posted' | 'superseded' | 'expired'
    - `blockedReason` string, nullable
    - `escalatedAt` string, date-time, nullable
    - `escalationReason` string, nullable
    - `metadata` object
      - `clarification` ScheduleProposalClarification
        - `state` 'draft' | 'sent', required
        - `question` string, required
        - `draftedAt` string, date-time, required
        - `sentAt` string, date-time
        - `sentByUserId` string, uuid, nullable
        - `threadId` string, uuid
        - `initialMessageId` string, uuid
        - `thread` ScheduleProposalClarificationThread
          - `id` string, uuid, required
          - `status` 'open' | 'resolved' | 'archived', required
          - `ownership` 'ai' | 'accountant', required
          - `blocksClose` false, required
          - `initialMessageId` string, uuid, required
          - `hasCustomerReply` boolean, required
          - `customerReplyCount` integer, required
          - `lastCustomerReplyAt` string, date-time, nullable
    - `reviewedBy` string, uuid, nullable
    - `reviewedAt` string, date-time, nullable
    - `reviewNotes` string, nullable
    - `editedInputs` object, nullable
    - `scheduleDefinitionIds` string[], nullable
    - `postedJeId` string, uuid, nullable
    - `createdBy` string, uuid, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `timeline` ScheduleProposalTimelineEntry[]
      - `id` string
      - `actorUserId` string, nullable
      - `createdAt` string, date-time
      - `changes` object: The decision payload (eventType, actorType, subAgent, confidence, before/after snapshots).

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