Skip to main content
GET
/
journal-entries
/
{journal_entry_id}
Fetch a journal entry with its lines
curl --request GET \
  --url https://ledger.clarivo.co/v1/journal-entries/{journal_entry_id} \
  --header 'Authorization: Bearer <token>'
{
  "journal_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "effective_at": "2023-12-25",
  "posted_at": "2023-11-07T05:31:56Z",
  "lines": [
    {
      "sequence": 16384,
      "account_code": "<string>",
      "amount_minor": "<string>",
      "currency": "<string>",
      "layer": "SETTLED",
      "loan_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "borrower_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "external_ref": "<string>"
    }
  ],
  "correlation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "reverses_entry_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "<string>",
  "actor": "<string>"
}

Authorizations

​
Authorization
string
header
required

OAuth2 JWT bearer tokens. Tokens are validated at API Gateway via a Lambda Authorizer that verifies signature against the issuer's JWKS, checks iss, aud, exp, nbf, and the tenant_id custom claim. Granular scopes are required per operation.

Path Parameters

​
journal_entry_id
string<uuid>
required
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"11111111-1111-1111-1111-111111111111"

Response

Journal entry + lines

​
journal_entry_id
string<uuid>
required
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"11111111-1111-1111-1111-111111111111"

​
event_type
enum<string>
required
Available options:
disbursement,
disbursement_settled,
accrual,
payment_received,
payment_allocated,
payment_returned,
fee_assessed,
fee_waived,
chargeoff,
recovery,
refinance,
restructure,
reversal,
manual_adjustment
​
effective_at
string<date>
required
​
posted_at
string<date-time>
required

RFC 3339 timestamp, UTC.

​
lines
object[]
required
Minimum array length: 2
​
correlation_id
string<uuid>
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"11111111-1111-1111-1111-111111111111"

​
reverses_entry_id
string<uuid>
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"11111111-1111-1111-1111-111111111111"

​
description
string
​
actor
string