Scoring Admin

Server

Get the scoring admin overview

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/overview

Keycloak-protected operator view for Credit Intelligence. Returns ingestion totals, score-decision totals, score-only handoffs, pending monthly files, and subject-link verification state.

Get the scoring admin overview › query Parameters

tenant_id

string

partner_code

string

Get the scoring admin overview › Headers

X-Request-Id

string

Client-generated ID for this HTTP attempt. Echoed in responses and logs.

X-Correlation-Id

string

Stable ID shared by all calls in one actor flow, saga, or operator action. Echoed in responses and logs.

Get the scoring admin overview › Responses

Admin overview

ScoringAdminOverview

generated_at

string · date-time

object

GET/score-decisions/admin/overview

curl https://credit-intelligence.mobicred.net/api/v1/score-decisions/admin/overview \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "generated_at": "2024-08-25T15:00:00Z",
  "filters": {},
  "totals": {
    "ingestion_jobs": 0,
    "score_decisions": 0,
    "subject_links": 0
  },
  "ingestion": {
    "by_status": {
      "key": 0
    },
    "pending_batch_files": 0
  },
  "scoring": {
    "by_band": {
      "key": 0
    },
    "by_execution_status": {
      "key": 0
    },
    "score_only_handoffs": 0,
    "recent_score_only_handoffs": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "tenantid": "tenantid",
        "partnercode": "partnercode",
        "subjectid": "subjectid",
        "productcode": "productcode",
        "requestedamount": 0,
        "decisionrequesthash": "decisionrequesthash",
        "score": 0,
        "band": "approve",
        "modelversion": "mobicred-explainable-score-v1",
        "reasoncodes": {},
        "featuresnapshotid": "00000000-0000-0000-0000-000000000000",
        "decidedat": "2024-08-25T15:00:00Z",
        "decisiontrace": {},
        "isActive": true,
        "createdAt": "2024-08-25T15:00:00Z",
        "updatedAt": "2024-08-25T15:00:00Z"
      }
    ]
  },
  "identity": {
    "by_verification_status": {
      "key": 0
    },
    "unverified_subject_links": 0,
    "recent_unverified_subject_links": [
      {}
    ]
  }
}

json

application/json

Get live dashboard summary read model

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/dashboard-summary

Returns score totals, 0-1200 score-range distribution, partner/product/channel/country/city/zone breakdowns, and daily trends for the scoring admin dashboard.

Get live dashboard summary read model › query Parameters

tenant_id

string

partner_code

string

product_code

string

date_from

string · date-time

date_to

string · date-time

channel

string

decision

string · enum

Enum values:

approve

review

decline

country_code

string · minLength: 2 · maxLength: 2

city

string

zone

string

Get live dashboard summary read model › Responses

Dashboard summary read model

ScoringDashboardSummary

generated_at

string · date-time

object

object[]

GET/score-decisions/admin/dashboard-summary

curl https://credit-intelligence.mobicred.net/api/v1/score-decisions/admin/dashboard-summary \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "generated_at": "2024-08-25T15:00:00Z",
  "filters": {},
  "summary": {
    "total_decisions": 0,
    "average_score": 0,
    "requested_amount_total": 0,
    "approve_count": 0,
    "review_count": 0,
    "decline_count": 0
  },
  "breakdowns": {
    "by_band": {
      "key": 0
    },
    "by_score_range": {
      "key": 0
    },
    "by_partner": {
      "key": 0
    },
    "by_product": {
      "key": 0
    },
    "by_channel": {
      "key": 0
    },
    "by_country": {
      "key": 0
    },
    "by_city": {
      "key": 0
    },
    "by_zone": {
      "key": 0
    }
  },
  "trends": [
    {
      "day": "day",
      "total_decisions": 0,
      "average_score": 0,
      "approve_count": 0,
      "review_count": 0,
      "decline_count": 0
    }
  ]
}

json

application/json

Search score decisions for dashboard tables

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/search

Paged read model for the scoring admin table, global lookup, filters, and drilldowns. Database remains the source of truth; Elasticsearch may serve search/facet acceleration when configured.

Search score decisions for dashboard tables › query Parameters

page

integer · min: 1

Default: 1

limit

integer · min: 1 · max: 100

Default: 10

q

string · maxLength: 200

sortBy

string

Default: decided_at

sortOrder

string · enum

Enum values:

ASC

DESC

Default: DESC

tenant_id

string

partner_code

string

product_code

string

date_from

string · date-time

date_to

string · date-time

channel

string

decision

string · enum

Enum values:

approve

review

decline

country_code

string · minLength: 2 · maxLength: 2

city

string

zone

string

Search score decisions for dashboard tables › Responses

Paged score decisions

ScoreDecisionPage

ScoreDecisionResponse[]

PaginationMeta

GET/score-decisions/admin/search

curl https://credit-intelligence.mobicred.net/api/v1/score-decisions/admin/search \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "tenantid": "tenantid",
      "partnercode": "partnercode",
      "subjectid": "subjectid",
      "productcode": "productcode",
      "requestedamount": 0,
      "decisionrequesthash": "decisionrequesthash",
      "score": 0,
      "band": "approve",
      "modelversion": "mobicred-explainable-score-v1",
      "reasoncodes": {},
      "featuresnapshotid": "00000000-0000-0000-0000-000000000000",
      "decidedat": "2024-08-25T15:00:00Z",
      "decisiontrace": {},
      "isActive": true,
      "createdAt": "2024-08-25T15:00:00Z",
      "updatedAt": "2024-08-25T15:00:00Z"
    }
  ],
  "meta": {
    "total": 0,
    "page": 0,
    "limit": 0,
    "totalPages": 0,
    "hasNextPage": true,
    "hasPreviousPage": true
  }
}

json

application/json

Rebuild scoring dashboard Elasticsearch indexes from Postgres

POST

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/search/reindex

Operator recovery endpoint for staging resets or Elasticsearch downtime. Postgres remains the source of truth. This replays authoritative score decisions and ingestion jobs into the configured Elasticsearch write aliases; normal create/update/delete writes also sync to Elasticsearch.

Rebuild scoring dashboard Elasticsearch indexes from Postgres › query Parameters

limit

integer · min: 1 · max: 100

Default: 10

tenant_id

string

partner_code

string

product_code

string

date_from

string · date-time

date_to

string · date-time

channel

string

decision

string · enum

Enum values:

approve

review

decline

country_code

string · minLength: 2 · maxLength: 2

city

string

zone

string

Rebuild scoring dashboard Elasticsearch indexes from Postgres › Responses

Reindex result for score decisions and ingestion jobs

generated_at

string · date-time · required

mode

string · required

source_of_truth

string · required

SearchReindexResult · required

search_usage

string

Inspect Elasticsearch dashboard sync status

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/search/sync-status

Returns whether search indexing is enabled and the durable outbox counts for failed or pending search sync work. Postgres remains the source of truth.

Inspect Elasticsearch dashboard sync status › Responses

Search sync status

SearchSyncStatus

generated_at

string · date-time

search_indexing_enabled

boolean

source_of_truth

string

object

GET/score-decisions/admin/search/sync-status

curl https://credit-intelligence.mobicred.net/api/v1/score-decisions/admin/search/sync-status \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "generated_at": "2024-08-25T15:00:00Z",
  "search_indexing_enabled": true,
  "source_of_truth": "postgres",
  "sync": {
    "available": true,
    "reason": "reason",
    "source_of_truth": "postgres",
    "projection": "elasticsearch",
    "freshness": "catching_up",
    "totals": {
      "total": 4,
      "pending": 2,
      "failed": 1,
      "dead_letter": 0,
      "retry_ready": 1,
      "max_attempts": 3,
      "oldest_retryable_age_seconds": 120
    },
    "rows": [
      {
        "index_kind": "scoreDecision",
        "status": "pending",
        "total": 4,
        "attempts": 6,
        "max_attempts": 6,
        "oldest_created_at": "2024-08-25T15:00:00Z",
        "oldest_next_attempt_at": "2024-08-25T15:00:00Z"
      }
    ]
  }
}

json

application/json

Retry pending Elasticsearch dashboard sync work

POST

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/search/sync-retry

Replays pending or failed search sync outbox rows into Elasticsearch. Use this for short recoveries after temporary Elasticsearch outages; use reindex for broader staging resets or template rebuilds.

Retry pending Elasticsearch dashboard sync work › query Parameters

limit

integer · min: 1 · max: 100

Maximum outbox rows to retry in this operator action.

Default: 100

Retry pending Elasticsearch dashboard sync work › Responses

Search sync retry result

SearchSyncRetryResult

generated_at

string · date-time

source_of_truth

string

object

Get dashboard filter facets

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/filter-facets

Returns available partner, product, channel, geography, decision, score range, evidence quality, and review-status facet counts for dashboard controls.

Get dashboard filter facets › query Parameters

tenant_id

string

partner_code

string

product_code

string

date_from

string · date-time

date_to

string · date-time

channel

string

decision

string · enum

Enum values:

approve

review

decline

country_code

string · minLength: 2 · maxLength: 2

city

string

zone

string

Get dashboard filter facets › Responses

Dashboard filter facets

ScoringDashboardFacets

generated_at

string · date-time

object

Get score aggregates by geography

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/geo-aggregates

Returns country/city/zone aggregates used by the Geo Intelligence map. The API is data-driven so Ivory Coast, Senegal, and later UEMOA countries can be added through reference data instead of dashboard code changes.

Get score aggregates by geography › query Parameters

tenant_id

string

partner_code

string

product_code

string

date_from

string · date-time

date_to

string · date-time

channel

string

decision

string · enum

Enum values:

approve

review

decline

country_code

string · minLength: 2 · maxLength: 2

city

string

zone

string

Get score aggregates by geography › Responses

Geographic aggregates

ScoringGeoAggregates

generated_at

string · date-time

object

object[]

Get composed Geo Intelligence dashboard panels

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/geo-intelligence

Composes live score geography with identity-link coverage, source freshness, partner footprint, policy packs, zone references, and geography guardrails. Postgres remains the source of truth; Elasticsearch is only used for search and audit exploration.

Get composed Geo Intelligence dashboard panels › query Parameters

tenant_id

string

partner_code

string

product_code

string

date_from

string · date-time

date_to

string · date-time

channel

string

decision

string · enum

Enum values:

approve

review

decline

country_code

string · minLength: 2 · maxLength: 2

city

string

zone

string

Get composed Geo Intelligence dashboard panels › Responses

Geo Intelligence dashboard panels

ScoringGeoIntelligence

generated_at

string · date-time

object

source_of_truth

string

search_usage

string

object

Declares which filters apply to each composed panel.

object

GET/score-decisions/admin/geo-intelligence

curl https://credit-intelligence.mobicred.net/api/v1/score-decisions/admin/geo-intelligence \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "generated_at": "2024-08-25T15:00:00Z",
  "filters": {},
  "source_of_truth": "postgres",
  "search_usage": "search_usage",
  "panel_scopes": {},
  "privacy": {
    "min_cohort_size": 30,
    "suppressed_zone_count": 0,
    "rule": "rule"
  },
  "scope": {
    "initial_country": "CI",
    "next_country": "SN",
    "expansion_order": [
      "string"
    ],
    "country_options": [
      "string"
    ],
    "city_options": [
      "string"
    ],
    "zone_options": [
      "string"
    ],
    "adaptation_rule": "adaptation_rule"
  },
  "coverage": {
    "total_decisions": 0,
    "countries": 0,
    "cities": 0,
    "zone_count": 0,
    "average_evidence_quality": 0,
    "live_zone_reference_matches": 0,
    "zone_reference_count": 0,
    "suppressed_zone_count": 0,
    "min_cohort_size": 0,
    "zones": [
      {
        "country_code": "country_code",
        "city": "city",
        "zone": "zone",
        "latitude": 0,
        "longitude": 0,
        "total_decisions": 0,
        "average_score": 0,
        "approve_count": 0,
        "review_count": 0,
        "decline_count": 0,
        "average_evidence_quality": 0,
        "policy_reference_status": "referenced",
        "coverage_share": 0,
        "min_cohort_size": 0,
        "suppressed": true,
        "suppression_reason": "suppression_reason"
      }
    ]
  },
  "identity_coverage": {
    "total_links": 0,
    "verified_links": 0,
    "unverified_links": 0,
    "verified_share": 0,
    "verification_statuses": {
      "key": 0
    }
  },
  "evidence_freshness": {
    "high_trust_sources": 0,
    "stale_sources": 0,
    "sources": [
      {}
    ]
  },
  "partner_footprint": {
    "scoring_partners": 0,
    "source_backed_partners": 0,
    "partners": [
      {}
    ]
  },
  "risk_anomalies": {
    "geography_guardrail": "context_only_not_approval_or_decline_alone",
    "review_heavy_zones": [
      {}
    ],
    "low_evidence_zones": [
      {}
    ]
  },
  "policy_readiness": {
    "policy_pack_count": 0,
    "zone_reference_count": 0,
    "countries": [
      {}
    ]
  }
}

json

application/json

Get selected subject score detail

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/subjects/{subjectId}

Returns the selected user score panel details by canonical subject id, decision id, phone number, or partner customer reference.

Get selected subject score detail › path Parameters

subjectId

string · required

Get selected subject score detail › query Parameters

tenant_id

string

partner_code

string

product_code

string

date_from

string · date-time

date_to

string · date-time

channel

string

decision

string · enum

Enum values:

approve

review

decline

country_code

string · minLength: 2 · maxLength: 2

city

string

zone

string

Get selected subject score detail › Responses

Subject score detail

ScoringSubjectDetail

generated_at

string · date-time

object

GET/score-decisions/admin/subjects/{subjectId}

curl https://credit-intelligence.mobicred.net/api/v1/score-decisions/admin/subjects/:subjectId \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "generated_at": "2024-08-25T15:00:00Z",
  "filters": {},
  "subject": {
    "subject_id": "ci-demo-subject-00001",
    "latest_decision_id": "latest_decision_id",
    "latest_score": 0,
    "latest_band": "600-749",
    "latest_decision": "approve",
    "model_version": "model_version",
    "partner_codes": [
      "string"
    ],
    "product_codes": [
      "string"
    ],
    "channels": [
      "string"
    ],
    "country_code": "country_code",
    "city": "city",
    "zone": "zone",
    "latitude": 0,
    "longitude": 0,
    "evidence_quality": 0,
    "execution_status": "execution_status",
    "core_execution_ready": true,
    "score_only": true,
    "requested_amount_total": 0,
    "decision_count": 0,
    "anomaly_count": 0,
    "explanation": {},
    "recent_decisions": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "tenantid": "tenantid",
        "partnercode": "partnercode",
        "subjectid": "subjectid",
        "productcode": "productcode",
        "requestedamount": 0,
        "decisionrequesthash": "decisionrequesthash",
        "score": 0,
        "band": "approve",
        "modelversion": "mobicred-explainable-score-v1",
        "reasoncodes": {},
        "featuresnapshotid": "00000000-0000-0000-0000-000000000000",
        "decidedat": "2024-08-25T15:00:00Z",
        "decisiontrace": {},
        "isActive": true,
        "createdAt": "2024-08-25T15:00:00Z",
        "updatedAt": "2024-08-25T15:00:00Z"
      }
    ]
  }
}

json

application/json

Get active scoring admin session

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/session

Returns the Keycloak staff identity and scopes used by the dashboard profile menu.

Get active scoring admin session › Responses

Active admin session

ScoringAdminSession

generated_at

string · date-time

object

Get scoring admin notification inbox

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/notifications

Returns dashboard notification items derived from live review, evidence, file-processing, and identity-link counters.

Get scoring admin notification inbox › query Parameters

tenant_id

string

partner_code

string

product_code

string

date_from

string · date-time

date_to

string · date-time

channel

string

decision

string · enum

Enum values:

approve

review

decline

country_code

string · minLength: 2 · maxLength: 2

city

string

zone

string

Get scoring admin notification inbox › Responses

Notification inbox

ScoringAdminNotifications

generated_at

string · date-time

object

unread_count

integer

object

object[]

Record scoring admin review action

POST

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/{decisionId}/review-actions

Records an operator review action in the authoritative score decision trace without mutating the score or final credit execution status.

Record scoring admin review action › path Parameters

decisionId

string · uuid · required

Score decision id to review.

Record scoring admin review action › Request Body

action

string · enum · required

Enum values:

approve

request_evidence

escalate

mark_complete

reject

note

string · maxLength: 1000

Record scoring admin review action › Responses

Review action recorded

ScoringReviewActionResult

generated_at

string · date-time

source_of_truth

string · enum

Enum values:

postgres

object

ScoreDecisionResponse

POST/score-decisions/admin/{decisionId}/review-actions

curl https://credit-intelligence.mobicred.net/api/v1/score-decisions/admin/:decisionId/review-actions \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "action": "request_evidence",
  "note": "Partner statement rows are missing for the current scoring window."
}'

Example Request Body

{
  "action": "request_evidence",
  "note": "Partner statement rows are missing for the current scoring window."
}

json

application/json

Example Responses

{
  "generated_at": "2024-08-25T15:00:00Z",
  "source_of_truth": "postgres",
  "review_action": {
    "action": "approve",
    "note": "note",
    "reviewed_at": "2024-08-25T15:00:00Z",
    "reviewer": {},
    "previous_action": "previous_action",
    "previous_reviewed_at": "previous_reviewed_at"
  },
  "score_decision": {
    "id": "00000000-0000-0000-0000-000000000000",
    "tenantid": "tenantid",
    "partnercode": "partnercode",
    "subjectid": "subjectid",
    "productcode": "productcode",
    "requestedamount": 0,
    "decisionrequesthash": "decisionrequesthash",
    "score": 0,
    "band": "approve",
    "modelversion": "mobicred-explainable-score-v1",
    "reasoncodes": {},
    "featuresnapshotid": "00000000-0000-0000-0000-000000000000",
    "decidedat": "2024-08-25T15:00:00Z",
    "decisiontrace": {},
    "isActive": true,
    "createdAt": "2024-08-25T15:00:00Z",
    "updatedAt": "2024-08-25T15:00:00Z"
  }
}

json

application/json

List score-only handoffs

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/score-only

Score decisions that are valid scoring results but not ready for Core/Fineract credit execution.

List score-only handoffs › query Parameters

page

integer · min: 1

Default: 1

limit

integer · min: 1 · max: 100

Default: 10

tenant_id

string

partner_code

string

List score-only handoffs › Responses

200

Score-only handoffs

No data returned

List monthly files waiting for parser processing

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/pending-batch-files

List monthly files waiting for parser processing › query Parameters

page

integer · min: 1

Default: 1

limit

integer · min: 1 · max: 100

Default: 10

tenant_id

string

partner_code

string

List monthly files waiting for parser processing › Responses

200

Pending batch files

No data returned

List subject links not yet verified for scoring

GET

https://credit-intelligence.mobicred.net/api/v1

/score-decisions/admin/unverified-subject-links

List subject links not yet verified for scoring › query Parameters

page

integer · min: 1

Default: 1

limit

integer · min: 1 · max: 100

Default: 10

tenant_id

string

partner_code

string

List subject links not yet verified for scoring › Responses

200

Unverified subject links

No data returned

Score Decisions