---
title: "Creates home mortgage disclosure responses for an application."
method: PUT
path: "/posfinancing/rest/v2/applications/{applicationId}/home-mortgage-disclosures"
tags: ["Home Card"]
---

# Creates home mortgage disclosure responses for an application.

`PUT /posfinancing/rest/v2/applications/{applicationId}/home-mortgage-disclosures`

## Request

- Base URL: `https://devint01-api.goodleap.com`
- URL: `https://devint01-api.goodleap.com/posfinancing/rest/v2/applications/{applicationId}/home-mortgage-disclosures`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/goodleap/apis/developer-api/docs/posfinancing/rest/v2/applications/:applicationId/home-mortgage-disclosures/put.ts> (a function with typed inputs; its response is checked against the schema)

Submit Home Mortgage Disclosure Responses

## Path parameters

- `applicationId` string, uuid, required

## Request body

- UndefinedCreateHmdaResponsesInput
  - `payload` UndefinedCreateHmdaApplicantResponsesInput[], required: The array of applicant responses.
    - `applicantRole` 'APPLICANT' | 'COAPPLICANT', required: Who answered the questions (e.g., APPLICANT, COAPPLICANT).
    - `responses` UndefinedCreateHmdaResponseItemInput[], required: The array of HMDA response items for this applicant.
      - `questionId` string, required: Foreign key to the HMDA question.
      - `value` string, required: The exact value submitted by the user.
      - `collectionMethod` 'SELF' | 'VISUAL_OBSERVATION_OR_SURNAME' | 'ORIGINATOR_INPUT' | 'AUTOFILLED', required: Required by HMDA when applicable for GMI.
  - `token` string, required: The signed JWT token.

## Response `204`

The request has been processed successfully.

## Other responses

- `400`: The request cannot be processed due to malformed data.
- `401`: Unauthorized access to the requested resource.
- `403`: Access to the requested resource is forbidden.
- `404`: The resource was not found.

## Changes

- **2026-10-29** `30a51d431498`: 1 info
  - api operation id `putApplicationsByApplicationIdHomeMortgageDisclosures` was added
- **2026-08-14** `69189f53112f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/goodleap/apis/developer-api/changes/posfinancing/rest/v2/applications/:applicationId/home-mortgage-disclosures/put.md)

---

[API](https://skmtc.dev/goodleap/apis/developer-api.md) - [All operations](https://skmtc.dev/goodleap/apis/developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/goodleap/apis/developer-api/revisions/30a51d431498?raw)