> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pylon.mortgage/llms.txt
> Use this file to discover all available pages before exploring further.

# Interested party contributions (IPC)

> Closing costs paid on the borrower's behalf by a party with a stake in the sale, and the guideline limit on how much they can contribute

**Interested party contributions (IPC)** are closing costs paid on the borrower's behalf by someone with a financial interest in the transaction, most often the property seller. Builders, developers, and real estate agents are other common sources. The most familiar form is a **seller credit** that covers part of the borrower's closing costs.

Contributions like these are limited because they can inflate the sales price without changing what the property is worth. Fannie Mae and Freddie Mac both cap them (see the [guideline references](#guideline-references)) and treat any amount over the cap as a **sales concession**. A sales concession is deducted from the sales price, which lowers the price used to calculate [LTV](https://docs.pylon.mortgage/entity-models/key-concepts/ltv.md) and [CLTV](https://docs.pylon.mortgage/entity-models/key-concepts/cltv.md). That makes it worth knowing where a loan stands against its limit well before closing.

## The limit

For conventional loans, the most interested parties may contribute depends on the property's occupancy and its loan-to-value ratio. Fannie Mae and Freddie Mac publish the same maximums:

| Occupancy | LTV ratio | Maximum contribution |
| - | - | - |
| Principal residence or second home | Above 90% | 3% |
| Principal residence or second home | 75.01% to 90% | 6% |
| Principal residence or second home | 75% or less | 9% |
| Investment property | Any | 2% |

Fannie Mae measures the ratio as LTV/CLTV and Freddie Mac as LTV/total LTV (TLTV), the ratio that counts all liens on the property. Pylon uses the loan's [combined loan-to-value](https://docs.pylon.mortgage/entity-models/key-concepts/cltv.md) to place it in a tier.

Pylon applies the percentage to the **lower of the sales price and the appraised value**. Fannie Mae states this basis directly; Freddie Mac refers to the property's value as defined in Section 4203.1(a) of its Guide. Other mortgage types have their own rules, and Pylon does not return a limit for them.

Each guide also leaves some contributions outside the limit, such as fees the seller customarily pays under local custom. See the [guideline references](#guideline-references) for the full lists of exceptions.

**Example:**

* Sales price: \$500,000, appraised at \$510,000
* Principal residence, 95% CLTV, so the limit is 3%
* Maximum contribution: 3% of \$500,000 = \$15,000
* Contributions on the loan: \$18,250
* Excess: \$18,250 - \$15,000 = \$3,250

## Querying IPC in GraphQL

Read a loan's contributions from the `interestedPartyContributions` field on `Loan`. It requires the `read:loan` scope, like the rest of the loan.

```graphql theme={null}
query LoanInterestedPartyContributions($loanId: ID!) {
  loan(id: $loanId) {
    id
    interestedPartyContributions {
      total
      maximumAmount
      maximumPercentage
      excessAmount
    }
  }
}
```

Select `percentageOfPurchasePrice` as well when you need the total as a share of the purchase price.

**Example response, within the limit:**

```json theme={null}
{
  "data": {
    "loan": {
      "id": "loan_123",
      "interestedPartyContributions": {
        "total": 6000,
        "maximumAmount": 15000,
        "maximumPercentage": 3,
        "excessAmount": null
      }
    }
  }
}
```

**Example response, over the limit:**

```json theme={null}
{
  "data": {
    "loan": {
      "id": "loan_123",
      "interestedPartyContributions": {
        "total": 18250,
        "maximumAmount": 15000,
        "maximumPercentage": 3,
        "excessAmount": 3250
      }
    }
  }
}
```

### Fields

| Field | Type | Description |
| - | - | - |
| `total` | Float | The total of the loan's closing-cost payments that are flagged as interested party contributions, in dollars. |
| `maximumAmount` | Float | The most contributions can total, in dollars: `maximumPercentage` applied to the lower of the sales price and the appraised value. |
| `maximumPercentage` | Float | The limit as a percentage, where `3` means 3%. It depends on occupancy and CLTV. |
| `percentageOfPurchasePrice` | Float | The total as a percentage of the purchase price. |
| `excessAmount` | Float | The amount by which `total` exceeds the limit, in dollars. |

### When a value is `null`

`interestedPartyContributions` is `null` when no contribution figures have been reported for the loan yet. Each field inside it can also be `null` on its own, so check each value before you use it:

* **`maximumPercentage` and `maximumAmount`** are `null` for loans that are not conventional, and while the loan's occupancy, CLTV, sales price, or appraised value is not yet known. A `null` limit means there is nothing to compare against, not that there is no limit.
* **`percentageOfPurchasePrice`** is `null` on a loan with no purchase price.
* **`excessAmount`** is `null` or `0` when contributions are within the limit. Treat any value above `0` as over the limit.

> [!NOTE]
>
> A `null` limit is different from `0`. Do not show a loan as within its limit unless `maximumAmount` has a value to compare `total` against.

### Reading where a loan stands

To show how close a loan is to its limit, compare `total` with `maximumAmount`:

```
remaining = maximumAmount - total        // when excessAmount is null or 0
over by   = excessAmount                 // when excessAmount is above 0
```

For the first example response above, the loan has \$9,000 of room left under a \$15,000 limit. For the second, it is \$3,250 over.

## Guideline references

The limit comes from the agencies' own guides. Guidelines change, so check the current text in each guide.

* **Fannie Mae:** [Selling Guide B3-4.1-02, Interested Party Contributions (IPCs)](https://selling-guide.fanniemae.com/sel/b3-4.1-02/interested-party-contributions-ipcs). Lists who counts as an interested party, the maximum financing concessions table, and how amounts over the limit become sales concessions.
* **Freddie Mac:** [Seller/Servicer Guide Section 5501.6, Interested party contributions](https://guide.freddiemac.com/app/guide/section/5501.6). Covers the interested party definition, the maximum financing concession limits, sales concessions in Section 5501.6(c), and the requirement that the amount and source of every contribution be documented and clearly shown on the Closing Disclosure.

## Related concepts

* [Combined Loan-to-Value (CLTV)](https://docs.pylon.mortgage/entity-models/key-concepts/cltv.md) - The ratio that sets the limit for principal residences and second homes
* [Loan-to-Value (LTV)](https://docs.pylon.mortgage/entity-models/key-concepts/ltv.md) - How an excess contribution lowers the price used for the ratio
* [Tolerance cure](https://docs.pylon.mortgage/entity-models/key-concepts/tolerance-cure.md) - The other closing-cost rule that can change who pays what at closing
* [Loan](https://docs.pylon.mortgage/entity-models/loan.md) - The entity that carries `interestedPartyContributions`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.