List journal entries

List all journal entries for a business with comprehensive filtering.

Features:

• Filter by date range (date_from, date_to)
• Filter by account (entries affecting a specific account)
• Filter by status (draft, approved, rejected)
• Filter by created_by (ai, manual, system, import)
• Filter by posted status
• Search by description, reference, or sequence number
• Pagination support (default: 20 per page, max: 100)

Response includes:

• Entry sequence number, date, reference, description
• Total debit and credit amounts
• Balance status
• Status and creation metadata
• Posted status and timestamp
• Source document type and reference (invoice, bill, payment, etc.)

GET /v1/platform/businesses/{business_id}/general-ledger/journal-entries

List journal entries

cURL

curl --request GET \
  --url https://sandbox.thredfi.com/v1/platform/businesses/{business_id}/general-ledger/journal-entries/ \
  --header 'Authorization: Bearer <token>'

200

{
  "count": 123,
  "page_info": {
    "total_count": 123,
    "current_page": 1,
    "total_pages": 7,
    "page_size": 20
  },
  "results": [
    {
      "id": "je-uuid-001",
      "sequence_number": "JE-2024-0042",
      "entry_date": "2024-03-28",
      "reference": "INV-0042",
      "description": "Customer invoice for The Red Lion Pub Ltd",
      "currency": "GBP",
      "total_debit": 540000,
      "total_credit": 540000,
      "is_balanced": true,
      "created_by": "system",
      "created_by_display": "System",
      "status": "approved",
      "status_display": "Approved",
      "is_posted": true,
      "posted_at": "2024-03-28T10:15:00Z",
      "bank_transaction_id": null,
      "source_type": "invoice",
      "source_reference": "INV-0042",
      "created_at": "2024-03-28T10:10:00Z"
    }
  ]
}

Authorizations

PartnerJWTBusinessScopedJWTBasicAuthBearerUnscopedBearerBusinessScoped

Authorization · string · header · required

Partner-level JWT token (unscoped). Token payload includes partner_id. Business access is validated via partner ownership. Format: Bearer <your-jwt-token>

Use this for: Multi-business operations where the business_id is specified in the URL and partner has access to multiple businesses.

Path Parameters

business_id · string<uuid> · required

Business UUID

Query Parameters

account_id · string<uuid>

Filter entries affecting a specific account

created_by · string

Filter by creator: ai, manual, system, import

date_from · string<date>

Filter entries from this date (inclusive)

date_to · string<date>

Filter entries up to this date (inclusive)

is_posted · boolean

Filter by posted status

page · integer

Page number (default: 1)

page_size · integer

Items per page (default: 20, max: 100)

search · string

Search by description, reference, or sequence number

status · string

Filter by status: draft, approved, rejected

Response

200

application/json

count · integer · required

Total number of items

Example:

123

page_info · object · required

Show child attributes

Example:

{
  "total_count": 123,
  "current_page": 1,
  "total_pages": 7,
  "page_size": 20
}

results · object[] · required

Show child attributes