---
title: "List customer class assignment proposals"
method: GET
path: "/accountant/companies/{customerId}/classes/proposals"
tags: ["Accounting Classes"]
---

# List customer class assignment proposals

`GET /accountant/companies/{customerId}/classes/proposals`

## Request

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

## Query parameters

- `status` 'proposed' | 'approved' | 'applied' | 'rejected' | 'correction_proposed'
- `transactionId` string, uuid
- `limit` integer

## Response `200`

Accounting class proposals

- AccountingClassProposalsListResponse
  - `success` boolean
  - `data` AccountingClassProposal[]
    - `id` string, uuid
    - `companyId` string, uuid
    - `engineRunId` string, uuid, nullable
    - `transactionId` string, uuid, nullable
    - `transactionSplitId` string, uuid, nullable
    - `proposedClassId` string, uuid, nullable
    - `proposedClassName` string, nullable
    - `proposedClass` AccountingClass
      - `id` string, uuid
      - `companyId` string, uuid
      - `name` string
      - `description` string, nullable
      - `status` 'draft' | 'active' | 'inactive'
      - `source` 'accountant' | 'bookkeeping_engine' | 'import'
      - `isActive` boolean
      - `approvedAt` string, date-time, nullable
      - `approvedByUserId` string, uuid, nullable
      - `metadata` object
      - `createdAt` string, date-time
      - `updatedAt` string, date-time
    - `approvedClassId` string, uuid, nullable
    - `status` 'proposed' | 'approved' | 'applied' | 'rejected' | 'correction_proposed'
    - `confidence` number, nullable
    - `applyEligibility` boolean
    - `source` 'bookkeeping_engine' | 'accountant' | 'import'
    - `reasoningSummary` string, nullable
    - `evidence` object
    - `metadata` object
    - `approvedAt` string, date-time, nullable
    - `approvedByUserId` string, uuid, nullable
    - `appliedAt` string, date-time, nullable
    - `rejectedAt` string, date-time, nullable
    - `rejectedByUserId` string, uuid, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

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

---

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