Skip to main content

​
Overview

These endpoints work at any time, independent of a live journey session. Use them to monitor the state of applications and receive status notifications.

​
List Enabled Products

Check which loan products are enabled for your API key. 
GET /api/v1/partner/products
Required scope: products:read Example response: 
{
  "success": true,
  "data": {
    "products": [
      {
        "code": "ONLINE_PERSONAL",
        "displayName": "Personal Loan",
        "category": "ONLINE",
        "channel": "API"
      },
      {
        "code": "ONLINE_GOLD",
        "displayName": "Gold Loan",
        "category": "ONLINE",
        "channel": "API"
      }
    ]
  }
}

​
Get a Single Application’s Status

Retrieve the current status of a specific loan application by its applicationId. 
GET /api/v1/partner/leads/{applicationId}/status
Required scope: leads:status:read Example response: 
{
  "success": true,
  "data": {
    "applicationId": "app_xyz",
    "status": "COMPLETED"
  }
}
This endpoint requires only your x-api-key and signing headers — no journeySession is needed. It works for both hosted and headless journeys.

​
List Your Applications

Get a paginated list of all your loan applications. Returns metadata only — no raw PII is ever returned. 
GET /api/v1/partner/leads?page=1&limit=20
Required scope: leads:read

​
Query Parameters

ParameterTypeDefaultMaxDescription
pageinteger1—Page number (1-indexed)
limitinteger20100Results per page

​
Webhooks

For real-time push notifications instead of polling, subscribe to webhooks. Required scope: webhooks:manage

Advantages of Webhooks

  • Real-time updates — no polling delay
  • Reduces API call volume
  • Ideal for hosted mode integrations

When to Poll Instead

  • During initial development and testing
  • When webhook delivery is unreliable
  • For headless mode (already polling journey state)
Contact your EasyCred onboarding manager to configure your webhook endpoint URL and the events you want to subscribe to.

​
Status Values Reference

These are the terminal status values you may see on applications:
StatusDescription
COMPLETEDLoan disbursed successfully
REJECTEDThe lender declined the application
NO_OFFERS_AVAILABLENo lender produced an offer in time
OFFLINE_PROCESSINGNon-retryable — EasyCred operations team will follow up
ABANDONEDJourney exceeded maximum poll attempts
EXPIREDJourney passed its time-to-live (72 hours default)