integrations

List liabilities

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.usehearsay.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "integrations MCP server": {
    "url": "https://docs.usehearsay.com/mcp"
  }
}
Close
GET /financial-data/liabilities/get
Access token

Returns one page of liabilities for an account, a Plaid item, or every item linked to the case, split into credit card, mortgage and student loan lists; filter by type, overdue or tags. On a case shared with opposing counsel, accounts the caller may not see are excluded, and attachedTags leave out tags the other side added by hand. Returns 404 when a Plaid item or account id sent belongs to another case.

Query parameters

  • page number

    Default value is 1.

  • perPage number

    Default value is 10.

  • skip number

    If skip/limit not provided, page/perPage will take precedence

  • limit number

    If skip/limit not provided, page/perPage will take precedence

  • caseId string Required

    Case ID this financial data belongs to.

  • plaidItemId string

    Internal PlaidItem document ID. Optional for extraction code users — resolved automatically from caseId.

  • liabilityType string

    Filter by liability type.

    Values are credit, mortgage, or student.

  • isOverdue boolean

    Filter by overdue status. Applies to credit and student liabilities only.

  • financialAccountId string

    Filter by a specific financial account ID.

  • tagIds array[string]

    Filter liabilities that have at least one of the provided tag IDs.

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data object Required
      Hide data attributes Show data attributes object
      • total number Required
      • page number
      • perPage number
      • skip number
      • limit number
      • totalPages number Required
      • nextPage number | null Required
      • previousPage number | null Required
      • creditLiabilities array[object] Required
        Hide creditLiabilities attributes Show creditLiabilities attributes object
        • id string Required
        • financialAccount string Required
        • plaidAccountId string Required
        • liabilityType string Required
        • aprs array[object] Required
          Hide aprs attributes Show aprs attributes object
          • aprPercentage number Required
          • aprType string Required
          • balanceSubjectToApr number | null

            In currency units (e.g. dollars), not cents, as reported by Plaid.

          • interestChargeAmount number | null

            In currency units (e.g. dollars), not cents, as reported by Plaid.

        • isOverdue boolean | null
        • lastPaymentAmount number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • lastPaymentDate string | null
        • lastStatementIssueDate string | null
        • lastStatementBalance number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • minimumPaymentAmount number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • nextPaymentDueDate string | null
        • createdAt string(date-time) Required
        • updatedAt string(date-time) Required
        • tags array[object]
          Hide tags attributes Show tags attributes object
          • id string Required
          • name string Required
        • attachedTags array[object]
          Hide attachedTags attributes Show attachedTags attributes object
          • tagId string Required

            Tag id (Tag._id)

          • tag string Required

            Tag display name (Tag.name)

          • addedBy string Required

            Values are user, ai, auto, auto-import, system, or default.

          • addedById string | null
          • removedAt string(date-time) | null
          • removedBy string | null

            Values are user, ai, auto, auto-import, system, or default.

          • removedById string | null
      • mortgageLiabilities array[object] Required
        Hide mortgageLiabilities attributes Show mortgageLiabilities attributes object
        • id string Required
        • financialAccount string Required
        • plaidAccountId string Required
        • liabilityType string Required
        • accountNumber string | null

          Last 4 characters of the loan account number

        • currentLateFee number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • escrowBalance number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • hasPmi boolean | null
        • hasPrepaymentPenalty boolean | null
        • interestRate object
          Hide interestRate attributes Show interestRate attributes object
          • percentage number | null
          • type string | null
        • lastPaymentAmount number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • lastPaymentDate string | null
        • loanTypeDescription string | null
        • loanTerm string | null
        • maturityDate string | null
        • nextMonthlyPayment number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • nextPaymentDueDate string | null
        • originationDate string | null
        • originationPrincipalAmount number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • pastDueAmount number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • propertyAddress object
          Hide propertyAddress attributes Show propertyAddress attributes object
          • city string | null
          • country string | null
          • postalCode string | null
          • region string | null
          • street string | null
        • ytdInterestPaid number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • ytdPrincipalPaid number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • createdAt string(date-time) Required
        • updatedAt string(date-time) Required
        • tags array[object]
          Hide tags attributes Show tags attributes object
          • id string Required
          • name string Required
        • attachedTags array[object]
          Hide attachedTags attributes Show attachedTags attributes object
          • tagId string Required

            Tag id (Tag._id)

          • tag string Required

            Tag display name (Tag.name)

          • addedBy string Required

            Values are user, ai, auto, auto-import, system, or default.

          • addedById string | null
          • removedAt string(date-time) | null
          • removedBy string | null

            Values are user, ai, auto, auto-import, system, or default.

          • removedById string | null
      • studentLiabilities array[object] Required
        Hide studentLiabilities attributes Show studentLiabilities attributes object
        • id string Required
        • financialAccount string Required
        • plaidAccountId string Required
        • liabilityType string Required
        • accountNumber string | null

          Last 4 characters of the loan account number

        • disbursementDates array[string] Required
        • expectedPayoffDate string | null
        • guarantor string | null
        • interestRatePercentage number Required
        • isOverdue boolean | null
        • lastPaymentAmount number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • lastPaymentDate string | null
        • lastStatementBalance number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • lastStatementIssueDate string | null
        • loanName string | null
        • loanStatus object
          Hide loanStatus attributes Show loanStatus attributes object
          • endDate string | null
          • type string | null
        • minimumPaymentAmount number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • nextPaymentDueDate string | null
        • originationDate string | null
        • originationPrincipalAmount number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • outstandingInterestAmount number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • paymentReferenceNumber string | null
        • repaymentPlan object
          Hide repaymentPlan attributes Show repaymentPlan attributes object
          • description string | null
          • type string | null
        • sequenceNumber string | null
        • servicerAddress object
          Hide servicerAddress attributes Show servicerAddress attributes object
          • city string | null
          • region string | null
          • street string | null
          • postalCode string | null
          • country string | null
        • ytdInterestPaid number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • ytdPrincipalPaid number | null

          In currency units (e.g. dollars), not cents, as reported by Plaid.

        • createdAt string(date-time) Required
        • updatedAt string(date-time) Required
        • tags array[object]
          Hide tags attributes Show tags attributes object
          • id string Required
          • name string Required
        • attachedTags array[object]
          Hide attachedTags attributes Show attachedTags attributes object
          • tagId string Required

            Tag id (Tag._id)

          • tag string Required

            Tag display name (Tag.name)

          • addedBy string Required

            Values are user, ai, auto, auto-import, system, or default.

          • addedById string | null
          • removedAt string(date-time) | null
          • removedBy string | null

            Values are user, ai, auto, auto-import, system, or default.

          • removedById string | null
    • statusCode number Required
    • timestamp string(date-time) Required
GET /financial-data/liabilities/get 
curl \
 --request GET 'http://api.example.com/financial-data/liabilities/get?caseId=string' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "data": {
    "total": 42,
    "page": 1,
    "perPage": 20,
    "skip": 0,
    "limit": 20,
    "totalPages": 3,
    "nextPage": 2,
    "previousPage": 42.0,
    "creditLiabilities": [
      {
        "id": "507f1f77bcf86cd799439011",
        "financialAccount": "65a1b2c3d4e5f6a7b8c9d0e2",
        "plaidAccountId": "BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp",
        "liabilityType": "credit",
        "aprs": [
          {
            "aprPercentage": 24.99,
            "aprType": "purchase_apr",
            "balanceSubjectToApr": 1562.32,
            "interestChargeAmount": 32.48
          }
        ],
        "isOverdue": false,
        "lastPaymentAmount": 168.25,
        "lastPaymentDate": "2026-01-05",
        "lastStatementIssueDate": "2026-01-10",
        "lastStatementBalance": 1708.77,
        "minimumPaymentAmount": 40.25,
        "nextPaymentDueDate": "2026-02-05",
        "createdAt": "2026-01-15T14:30:00.000Z",
        "updatedAt": "2026-01-15T14:30:00.000Z",
        "tags": [
          {
            "id": "65a1b2c3d4e5f6a7b8c9d0a1",
            "name": "Responsive"
          }
        ],
        "attachedTags": [
          {
            "tagId": "507f1f77bcf86cd799439011",
            "tag": "Important",
            "addedBy": "user",
            "addedById": "507f1f77bcf86cd799439012",
            "removedAt": "2026-05-04T09:42:00Z",
            "removedBy": "user",
            "removedById": "string"
          }
        ]
      }
    ],
    "mortgageLiabilities": [
      {
        "id": "507f1f77bcf86cd799439011",
        "financialAccount": "65a1b2c3d4e5f6a7b8c9d0e2",
        "plaidAccountId": "BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp",
        "liabilityType": "mortgage",
        "accountNumber": "4321",
        "currentLateFee": 25.5,
        "escrowBalance": 3141.54,
        "hasPmi": true,
        "hasPrepaymentPenalty": false,
        "interestRate": {
          "percentage": 3.99,
          "type": "fixed"
        },
        "lastPaymentAmount": 1875.32,
        "lastPaymentDate": "2026-01-01",
        "loanTypeDescription": "conventional",
        "loanTerm": "30 year",
        "maturityDate": "2051-02-01",
        "nextMonthlyPayment": 1875.32,
        "nextPaymentDueDate": "2026-02-01",
        "originationDate": "2021-01-15",
        "originationPrincipalAmount": 425000.5,
        "pastDueAmount": 1875.32,
        "propertyAddress": {
          "city": "Springfield",
          "country": "US",
          "postalCode": "62701",
          "region": "IL",
          "street": "123 Main St"
        },
        "ytdInterestPaid": 1150.42,
        "ytdPrincipalPaid": 724.9,
        "createdAt": "2026-01-15T14:30:00.000Z",
        "updatedAt": "2026-01-15T14:30:00.000Z",
        "tags": [
          {
            "id": "65a1b2c3d4e5f6a7b8c9d0a1",
            "name": "Responsive"
          }
        ],
        "attachedTags": [
          {
            "tagId": "507f1f77bcf86cd799439011",
            "tag": "Important",
            "addedBy": "user",
            "addedById": "507f1f77bcf86cd799439012",
            "removedAt": "2026-05-04T09:42:00Z",
            "removedBy": "user",
            "removedById": "string"
          }
        ]
      }
    ],
    "studentLiabilities": [
      {
        "id": "507f1f77bcf86cd799439011",
        "financialAccount": "65a1b2c3d4e5f6a7b8c9d0e2",
        "plaidAccountId": "BxBXxLj1m4HMXBm9WZZmCWVbPjX16EHwv99vp",
        "liabilityType": "student",
        "accountNumber": "4321",
        "disbursementDates": [
          "2018-08-20"
        ],
        "expectedPayoffDate": "2033-08-20",
        "guarantor": "DEPT OF ED",
        "interestRatePercentage": 5.25,
        "isOverdue": false,
        "lastPaymentAmount": 138.05,
        "lastPaymentDate": "2026-01-12",
        "lastStatementBalance": 18250.75,
        "lastStatementIssueDate": "2025-12-28",
        "loanName": "Consolidation",
        "loanStatus": {
          "endDate": "2033-08-20",
          "type": "repayment"
        },
        "minimumPaymentAmount": 138.05,
        "nextPaymentDueDate": "2026-02-12",
        "originationDate": "2018-08-20",
        "originationPrincipalAmount": 25000.5,
        "outstandingInterestAmount": 612.36,
        "paymentReferenceNumber": "4307799999",
        "repaymentPlan": {
          "description": "Standard Repayment",
          "type": "standard"
        },
        "sequenceNumber": "1",
        "servicerAddress": {
          "city": "Springfield",
          "region": "IL",
          "street": "456 Oak Ave",
          "postalCode": "62704",
          "country": "US"
        },
        "ytdInterestPaid": 79.84,
        "ytdPrincipalPaid": 58.21,
        "createdAt": "2026-01-15T14:30:00.000Z",
        "updatedAt": "2026-01-15T14:30:00.000Z",
        "tags": [
          {
            "id": "65a1b2c3d4e5f6a7b8c9d0a1",
            "name": "Responsive"
          }
        ],
        "attachedTags": [
          {
            "tagId": "507f1f77bcf86cd799439011",
            "tag": "Important",
            "addedBy": "user",
            "addedById": "507f1f77bcf86cd799439012",
            "removedAt": "2026-05-04T09:42:00Z",
            "removedBy": "user",
            "removedById": "string"
          }
        ]
      }
    ]
  },
  "statusCode": 200,
  "timestamp": "2026-01-15T10:15:00.000Z"
}