Loan History

Current and historical Quotient loan history data for user.

Get Quotient loan history for Farcaster users

post

Retrieves loan history including status, principal, repayments for up to 100 FIDs.

Body

application/json

Request model for loan history lookup.

fidany ofOptional

Farcaster ID to look up loans for

integerOptional

or

nullOptional

fidsany ofOptional

List of Farcaster IDs (max 100)

integer[]Optional

or

nullOptional

api_keystringRequired

API key for authentication

Responses

200

Successfully retrieved loan history

application/json

401

Unauthorized - Invalid API key

404

No loans found for the provided FIDs

422

Validation Error

application/json

500

Internal Server Error

post

/v1/loan-history

HTTPcURLJavaScriptPython

POST /v1/loan-history HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 37

{
  "fid": 1,
  "fids": [
    1
  ],
  "api_key": "text"
}

{
  "loans": [
    {
      "loan_id": "text",
      "fid": 1,
      "borrower": "text",
      "principal_usdc": 1,
      "total_repaid_usdc": 1,
      "remaining_usdc": 1,
      "loan_status": "text",
      "originated_at": "text",
      "last_repayment_at": "text",
      "fully_repaid_at": "text",
      "repayment_count": 1
    }
  ],
  "count": 1
}