> ## Documentation Index
> Fetch the complete documentation index at: https://entendre.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get classification status

> Gets the progress, posting results and review items of a classification job.

A completed job means that classification is finished, not that every item is posted. Check `totals.posting_failed`, `totals.posting_skipped` and `totals.pending_review`. The item results give the reasons.


## OpenAPI

````yaml openapi-public-preview.json GET /v1/classifications/{classification_id}
openapi: 3.1.0
info:
  title: Entendre API
  version: 1.0.0
  description: Programmatic access to crypto-native accounting and treasury operations.
servers:
  - url: https://api.entendre.finance
    description: Production API.
security:
  - ApiKey: []
tags:
  - name: Organization
    description: Read your organization profile and find members for agent assignments.
  - name: Transactions
    description: Find transactions, inspect their details and create manual records.
  - name: Sources
    description: >-
      Manage wallets, exchange accounts, bank accounts and other transaction
      sources.
  - name: Assets
    description: Inspect asset acquisitions, remaining quantities and cost basis.
  - name: Journals
    description: >-
      Create and post journal entries, correct eligible entries and sync posted
      journals to a connected general ledger.
  - name: Documents
    description: >-
      Upload documents, check processing status and link supporting evidence to
      transactions.
  - name: Legal Entities
    description: Manage the legal entities used in your accounting records.
  - name: Ledger Accounts
    description: Manage your chart of accounts and find accounts for journal entries.
  - name: Tags
    description: Create and manage tags to classify your records.
  - name: Accruals
    description: >-
      Create and post accruals, inspect their status and reverse eligible
      entries.
  - name: Cash Application
    description: Match deposits to invoices and manage the resulting cash applications.
  - name: Classification
    description: >-
      Classify transactions in a batch, post eligible entries and inspect the
      results.
  - name: Revaluation
    description: Run asset revaluations for an accounting period and check their results.
  - name: Accounting Periods
    description: Check whether a period is ready to close, then close or reopen it.
  - name: Income Statement
    description: View revenue, expenses and net income for a reporting period.
  - name: Balance Sheet
    description: View assets, liabilities and equity as of a reporting date.
  - name: Trial Balance
    description: Review ledger account balances and debit and credit totals.
  - name: Closing Positions
    description: View asset positions at the end of a reporting period.
  - name: Treasury Balances
    description: Review treasury balances by asset and source.
  - name: Realized Gains & Losses
    description: Review realized gains and losses from asset dispositions.
  - name: Asset Tax Lots
    description: Inspect asset tax lots, remaining quantities and cost basis.
  - name: Schedule of Dispositions
    description: >-
      Review asset dispositions and their proceeds, cost basis and gains or
      losses.
  - name: Financial Insights
    description: Review financial insights for your selected reporting context.
  - name: Agents
    description: Create agents, schedule their work and inspect their runs.
  - name: Memory
    description: Read, search and maintain the memory files your agents use.
  - name: Connections
    description: Connect providers, manage authorization and disconnect.
  - name: GL Mapping
    description: >-
      Map ledger accounts and legal entities to your ERP. Import legal entities,
      tags and chart of accounts.
  - name: Request
    description: Request information, documents or connections from a client.
  - name: Client
    description: Manage your firm’s client relationships.
  - name: Team
    description: Invite team members and manage their access to your firm.
  - name: Settings
    description: Read and update your firm settings.
paths:
  /v1/classifications/{classification_id}:
    get:
      tags:
        - Classification
      summary: Get classification status
      description: >-
        Check classification progress, posting results and transactions that
        need review. Follow the cursor for more results.
      operationId: get_classification
      parameters:
        - name: classification_id
          in: path
          required: true
          description: ID of the classification.
          schema:
            type: string
            minLength: 1
          example: ref_507f1f77bcf86cd799439011
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 25
          description: Maximum number of result items to return.
        - name: cursor
          in: query
          required: false
          description: Cursor for nested result items, not a different job.
          schema:
            type: string
      responses:
        '200':
          description: The request succeeded.
          headers:
            X-Request-Id:
              description: Support correlation ID.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Classification'
                required:
                  - data
                additionalProperties: false
              example:
                data:
                  id: cls_507f1f77bcf86cd799439011
                  status: succeeded
                  status_url: /v1/classifications/cls_507f1f77bcf86cd799439011
                  total_count: 3
                  processed_count: 3
                  totals:
                    input: 3
                    classified: 3
                    pending_review: 0
                    unclassified: 0
                    auto_posted: 1
                    posting_failed: 1
                    posting_skipped: 1
                  items:
                    - transaction_id: txn_507f1f77bcf86cd799439011
                      status: classified
                      classification: EXPENSE
                      category_ledger_account_id: lac_507f1f77bcf86cd799439011
                      payment_account_id: lac_507f1f77bcf86cd799439012
                      confidence: 95
                      reason: Matched the transaction to its expense account.
                      missing_fields: []
                      posting_status: posted
                      journal_entry_id: je_507f1f77bcf86cd799439011
                      posting_message: null
                    - transaction_id: txn_507f1f77bcf86cd799439012
                      status: classified
                      classification: EXPENSE
                      category_ledger_account_id: lac_507f1f77bcf86cd799439011
                      payment_account_id: lac_507f1f77bcf86cd799439012
                      confidence: 95
                      reason: Matched the transaction to its expense account.
                      missing_fields: []
                      posting_status: failed
                      journal_entry_id: null
                      posting_message: Posting failed. Review the transaction before retrying.
                    - transaction_id: txn_507f1f77bcf86cd799439013
                      status: classified
                      classification: EXPENSE
                      category_ledger_account_id: lac_507f1f77bcf86cd799439011
                      payment_account_id: lac_507f1f77bcf86cd799439012
                      confidence: 95
                      reason: Matched the transaction to its expense account.
                      missing_fields: []
                      posting_status: skipped
                      journal_entry_id: null
                      posting_message: A required posting field is missing.
                  has_more: false
                  next_cursor: null
                  error: null
                  created_at: '2026-08-31T12:00:00Z'
                  completed_at: '2026-08-31T12:01:00Z'
                  review_url: null
        '400':
          description: >-
            The request is invalid. `error.fields` lists the fields to correct.
            Nothing was changed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: VALIDATION_ERROR
                  message: Invalid path, query or request body.
                  request_id: req_example
        '401':
          description: The API key is missing, invalid or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: UNAUTHORIZED
                  message: Authentication is required.
                  request_id: req_example
        '403':
          description: >-
            The API key does not have the required scope or is not associated
            with a user, or the action needs a review in the dashboard.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: FORBIDDEN
                  message: Insufficient access to organization
                  request_id: req_example
        '404':
          description: The resource does not exist, or your organization cannot access it.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: RESOURCE_NOT_FOUND
                  message: Resource not found
                  request_id: req_example
        '429':
          description: >-
            Too many requests. If the response has a `Retry-After` header, wait
            that many seconds before you retry. Otherwise, read `error.message`.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: RATE_LIMITED
                  message: Rate limit exceeded. Retry after 30s.
                  request_id: req_example
        '500':
          description: >-
            An unexpected error occurred. A write can still have taken effect;
            check the resource before you retry. Give the `request_id` to
            support.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: INTERNAL_ERROR
                  message: Internal server error
                  request_id: req_example
        '503':
          description: >-
            A service that this operation needs is unavailable. If the response
            has a `Retry-After` header, wait that many seconds. Check for
            earlier accepted work before you send the request again.
          headers:
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
                minimum: 1
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                error:
                  code: SERVICE_UNAVAILABLE
                  message: Service unavailable.
                  request_id: req_example
components:
  schemas:
    Classification:
      type: object
      properties:
        id:
          type: string
          description: Classification ID (`cls_…`).
          example: cls_507f1f77bcf86cd799439011
        status:
          type: string
          description: Job status.
          enum:
            - queued
            - in_progress
            - succeeded
            - partially_succeeded
            - failed
            - cancelled
        status_url:
          type: string
          description: URL to check this classification job.
        total_count:
          type: integer
          minimum: 0
          description: Transactions selected for this job.
        processed_count:
          type: integer
          minimum: 0
          description: Transactions processed across all result pages.
        totals:
          type: object
          properties:
            input:
              type: integer
              minimum: 0
              description: Selected transactions.
            classified:
              type: integer
              minimum: 0
              description: Classified transactions, including those posted.
            pending_review:
              type: integer
              minimum: 0
              description: Transactions that need review.
            unclassified:
              type: integer
              minimum: 0
              description: Transactions without a classification.
            auto_posted:
              type: integer
              minimum: 0
              description: Transactions with posted journal entries.
            posting_failed:
              type: integer
              minimum: 0
              description: Transactions whose journal posting failed, across all pages.
            posting_skipped:
              type: integer
              minimum: 0
              description: >-
                Transactions whose journal posting was skipped, across all
                pages.
          required:
            - input
            - classified
            - pending_review
            - unclassified
            - auto_posted
            - posting_failed
            - posting_skipped
          additionalProperties: false
          description: Counts across all result pages.
        items:
          type: array
          items:
            $ref: '#/components/schemas/ClassificationLine'
          description: Result items on this page.
        has_more:
          type: boolean
          description: Whether more result rows are available.
        next_cursor:
          type:
            - string
            - 'null'
          description: Cursor for the next result page.
        error:
          type:
            - object
            - 'null'
          properties:
            code:
              type: string
              description: Failure code.
            message:
              type: string
              description: Failure description.
          required:
            - code
            - message
          additionalProperties: false
          description: Why the job failed, or `null`.
        created_at:
          type: string
          description: ISO 8601 UTC timestamp.
          format: date-time
          example: '2026-08-31T12:00:00Z'
        completed_at:
          type:
            - string
            - 'null'
          description: Time the job finished (ISO 8601).
        review_url:
          type:
            - string
            - 'null'
          format: uri
          description: >-
            Dashboard link for reviewing the selected transactions, when
            available. This is not an additional approval step before automatic
            posting.
      required:
        - id
        - status
        - status_url
        - total_count
        - processed_count
        - totals
        - items
        - has_more
        - next_cursor
        - error
        - created_at
        - completed_at
        - review_url
      additionalProperties: false
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - request_id
          properties:
            code:
              type: string
              description: Machine-readable error code.
            message:
              type: string
              description: Technical description for developers.
            fields:
              type: object
              additionalProperties:
                type: string
              description: >-
                Present only on VALIDATION_ERROR. Maps failing field paths to
                reason strings.
            details:
              type: object
              additionalProperties: true
              description: >-
                Optional redacted diagnostic details. Request validation uses
                fields or field_errors.
            suggested_action:
              type: string
              description: A suggested next step.
            documentation_url:
              type: string
              format: uri
              description: Link to documentation about this error.
            request_id:
              type: string
              description: Unique request ID for support escalation.
          description: Error details.
    ClassificationLine:
      type: object
      properties:
        transaction_id:
          type: string
          description: Transaction ID.
        status:
          type: string
          enum:
            - classified
            - pending_review
            - unclassified
            - failed
          description: >-
            Classification outcome. `posting_status` gives the accounting
            result.
        classification:
          type:
            - string
            - 'null'
          description: Assigned transaction classification.
        category_ledger_account_id:
          type:
            - string
            - 'null'
          description: Assigned category ledger account.
        payment_account_id:
          type:
            - string
            - 'null'
          description: Payment ledger account.
        confidence:
          type:
            - number
            - 'null'
          description: Confidence of the classification.
        reason:
          type: string
          description: Reason for the classification or required review.
        missing_fields:
          type: array
          items:
            type: string
          description: Fields needed to complete classification.
        posting_status:
          type: string
          enum:
            - not_posted
            - posted
            - replayed
            - skipped
            - failed
          description: A classification can succeed even when posting is skipped or fails.
        journal_entry_id:
          type:
            - string
            - 'null'
          description: Created or previously posted journal entry.
        posting_message:
          type:
            - string
            - 'null'
          description: Posting failure or skip reason.
      required:
        - transaction_id
        - status
        - classification
        - category_ledger_account_id
        - payment_account_id
        - confidence
        - reason
        - missing_fields
        - posting_status
        - journal_entry_id
        - posting_message
      additionalProperties: false
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        Your organization API key. Some operations also need a key that is
        associated with a user; their pages say so.

````