Skip to main content
GET
/
service
/
general-ledger
/
accounting-periods
/
{period_id}
/
unposted-entries
curl -X GET https://kube.acho.io/service/general-ledger/accounting-periods/a3UM4R8nYh33A6hgda/unposted-entries \
  -H "Authorization: jwt YOUR_TOKEN"
{
  "period_id": "a3UM4R8nYh33A6hgda",
  "period_name": "January 2024",
  "total_unposted": 8,
  "by_document_type": {
    "journal_entries": {
      "draft": [
        {
          "id": "JE-2024-001",
          "memo": "Office supplies",
          "amount": 500.00,
          "created_at": "2024-01-15T10:00:00Z"
        }
      ],
      "pending_approval": [
        {
          "id": "JE-2024-002",
          "memo": "Payroll adjustment",
          "amount": 1500.00,
          "created_at": "2024-01-20T14:00:00Z"
        }
      ],
      "on_hold": [],
      "approved": []
    },
    "bills": {
      "draft": [
        {
          "id": "BILL-2024-001",
          "vendor": "Office Supplies Inc",
          "amount": 750.00,
          "due_date": "2024-02-15"
        }
      ],
      "pending_approval": [],
      "on_hold": [],
      "approved": []
    },
    "invoices": {
      "draft": [],
      "pending_approval": [
        {
          "id": "INV-2024-001",
          "customer": "Acme Corp",
          "amount": 4400.00,
          "due_date": "2024-02-15"
        }
      ],
      "on_hold": [],
      "approved": []
    },
    "bill_payments": {
      "draft": [],
      "pending_approval": [],
      "on_hold": [],
      "approved": []
    },
    "invoice_payments": {
      "draft": [],
      "pending_approval": [],
      "on_hold": [],
      "approved": []
    },
    "credit_memos": {
      "draft": [],
      "pending_approval": [],
      "on_hold": [],
      "approved": []
    }
  },
  "summary": {
    "by_status": {
      "draft": 2,
      "pending_approval": 2,
      "on_hold": 0,
      "approved": 0
    }
  }
}

Request

Retrieve all unposted documents in an accounting period. This is useful before closing a period to ensure all documents have been processed.

Headers

Authorization
string
required
JWT authentication token. Format: jwt YOUR_TOKEN

Path Parameters

period_id
string
required
The unique identifier of the accounting period
curl -X GET https://kube.acho.io/service/general-ledger/accounting-periods/a3UM4R8nYh33A6hgda/unposted-entries \
  -H "Authorization: jwt YOUR_TOKEN"
{
  "period_id": "a3UM4R8nYh33A6hgda",
  "period_name": "January 2024",
  "total_unposted": 8,
  "by_document_type": {
    "journal_entries": {
      "draft": [
        {
          "id": "JE-2024-001",
          "memo": "Office supplies",
          "amount": 500.00,
          "created_at": "2024-01-15T10:00:00Z"
        }
      ],
      "pending_approval": [
        {
          "id": "JE-2024-002",
          "memo": "Payroll adjustment",
          "amount": 1500.00,
          "created_at": "2024-01-20T14:00:00Z"
        }
      ],
      "on_hold": [],
      "approved": []
    },
    "bills": {
      "draft": [
        {
          "id": "BILL-2024-001",
          "vendor": "Office Supplies Inc",
          "amount": 750.00,
          "due_date": "2024-02-15"
        }
      ],
      "pending_approval": [],
      "on_hold": [],
      "approved": []
    },
    "invoices": {
      "draft": [],
      "pending_approval": [
        {
          "id": "INV-2024-001",
          "customer": "Acme Corp",
          "amount": 4400.00,
          "due_date": "2024-02-15"
        }
      ],
      "on_hold": [],
      "approved": []
    },
    "bill_payments": {
      "draft": [],
      "pending_approval": [],
      "on_hold": [],
      "approved": []
    },
    "invoice_payments": {
      "draft": [],
      "pending_approval": [],
      "on_hold": [],
      "approved": []
    },
    "credit_memos": {
      "draft": [],
      "pending_approval": [],
      "on_hold": [],
      "approved": []
    }
  },
  "summary": {
    "by_status": {
      "draft": 2,
      "pending_approval": 2,
      "on_hold": 0,
      "approved": 0
    }
  }
}

Response Fields

FieldTypeDescription
total_unpostednumberTotal count of unposted documents
by_document_typeobjectUnposted documents grouped by type and status
summary.by_statusobjectCount of documents by status

Usage

Use this endpoint before closing a period to:
  1. Identify pending work - See which documents need approval or posting
  2. Plan period close - Determine if you need to wait for approvals
  3. Avoid forced closes - Address unposted entries before closing