v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB

Loan Accounts

Get loan account PDD stage

Returns the current Brazilian PDD delinquency stage and accrual eligibility state.

get/api/v1/br/loan-accounts/{id}/pdd-stage

Path parameters

idstring uuid required

Loan account identifier.

Response

accrualStatestring required

Interest accrual state implied by the current stage: accruing or suspended.

businessDatestring required

Business date the current stage applies to (YYYY-MM-DD, UTC).

currentStagestring required

Current PDD delinquency stage: one of current, stage_1, stage_2, stage_3.

effectiveAtstring required

RFC3339 UTC timestamp at which the current stage became effective.

jurisdictionCodestring required

ISO jurisdiction code governing the staging (e.g. "BR").

latestTransitionIdstring required

UUID of the most recent PDD stage transition applied to the account.

loanAccountIdstring required

UUID of the loan account whose PDD staging state is reported.

profileVersionstring required

Jurisdiction profile version in effect for the staging rules.

reasonstring required

Reason recorded for entering the current stage.

triggeredBystring required

Actor or system that triggered the current stage.

updatedAtstring required

RFC3339 UTC timestamp when the staging state was last updated.

Example response

{
  "accrualState": "accruing",
  "businessDate": "2026-06-14",
  "currentStage": "stage_1",
  "effectiveAt": "2026-06-14T12:00:00Z",
  "jurisdictionCode": "BR",
  "latestTransition": {
    "accrualState": "accruing",
    "businessDate": "2026-06-14",
    "createdAt": "2026-06-14T12:00:00Z",
    "effectiveAt": "2026-06-14T12:00:00Z",
    "fromStage": "current",
    "id": "550e8400-e29b-41d4-a716-446655440002",
    "jurisdictionCode": "BR",
    "profileVersion": "1.0.0",
    "toStage": "stage_1"
  },
  "latestTransitionId": "550e8400-e29b-41d4-a716-446655440001",
  "loanAccountId": "550e8400-e29b-41d4-a716-446655440000",
  "profileVersion": "1.0.0",
  "updatedAt": "2026-06-14T12:00:00Z"
}