---
title: "Fetches the mortgage officer configuration for a state from application submission configuration. When categoryCode is omitted, the officer assigned to the state is returned."
method: GET
path: "/posfinancing/rest/v2/home-mortgage-disclosures"
tags: ["Home Card"]
---

# Fetches the mortgage officer configuration for a state from application submission configuration. When categoryCode is omitted, the officer assigned to the state is returned.

`GET /posfinancing/rest/v2/home-mortgage-disclosures`

Fetch Mortgage Officer Configuration

## Query parameters

- `lifecycleStatus` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'RETIRED'

## Response `200`

The request has been processed successfully.

- SchemaObject1
  - `payload` object, required — The response data.
    - `items` SUBMISSIONHomeMortgageDisclosureDto[], required — The list of home mortgage disclosures that match the query parameters.
      - `code` string, required — Stable logical identifier for the question (e.g., "HMDA_ETHNICITY_PRIMARY").
      - `section` string, required — HMDA section (e.g., "ETHNICITY", "RACE", "SEX").
      - `title` SUBMISSIONLocalizedTextDto, required
        - `default` string, required — The default text value.
        - `localizations` SUBMISSIONLocalizationEntryDto[], required — Array of localization entries.
          - `language` string, required — The language code (e.g., "en", "es").
          - `locale` string, required — The locale code (e.g., "en-US", "es-US").
          - `text` string, required — The localized text content.
      - `description` SUBMISSIONLocalizedTextDto
        - `default` string, required — The default text value.
        - `localizations` SUBMISSIONLocalizationEntryDto[], required — Array of localization entries.
          - `language` string, required — The language code (e.g., "en", "es").
          - `locale` string, required — The locale code (e.g., "en-US", "es-US").
          - `text` string, required — The localized text content.
      - `applicability` SUBMISSIONHmdaApplicabilityDto, required
        - `applicantRoles` string[], required — List of applicant roles this question applies to.
      - `responseSchema` SUBMISSIONHmdaResponseSchemaDto, required
        - `type` 'SINGLE_SELECT' | 'MULTI_SELECT' | 'NUMERIC' | 'TEXT' | 'DATE', required — The response type (e.g., "SINGLE_SELECT", "MULTI_SELECT", "NUMERIC", "TEXT", "DATE").
        - `allowedValues` string[] — Valid values for select-type questions.
        - `maxSelections` number — For multi-select questions, the maximum number of selections allowed.
      - `options` SUBMISSIONHmdaOptionDto[] — Only for select-type. Contains option metadata.
        - `key` string, required — Internal key for the option.
        - `label` SUBMISSIONLocalizedTextDto, required
          - `default` string, required — The default text value.
          - `localizations` SUBMISSIONLocalizationEntryDto[], required — Array of localization entries.
            - `language` string, required — The language code (e.g., "en", "es").
            - `locale` string, required — The locale code (e.g., "en-US", "es-US").
            - `text` string, required — The localized text content.
        - `value` string, required — The value sent by the client.
      - `visibility` SUBMISSIONHmdaVisibilityDto, required
        - `conditions` SUBMISSIONHmdaVisibilityConditionDto[], required — The conditions that determine the visibility of the HMDA question.
          - `field` string — The field to check.
          - `operator` 'ALWAYS' | 'EQUALS' | 'CONTAINS', required — The operator to use.
          - `value` string — The value to compare to.
        - `logic` 'ALL' | 'ANY', required — The logical operator to use.
      - `lifecycleStatus` 'DRAFT' | 'ACTIVE' | 'DEPRECATED' | 'RETIRED', required — Lifecycle status of the question.
      - `id` string, required — The unique identifier of the entity.
    - `token` string, required — The token to send back when persisting the responses associated with the Home Mortgage Disclosure questions.
    - `tokenExpiresAt` string, date-time, required — The expiration date of the token.

## Other responses

- `400` — The request cannot be processed due to malformed data.
- `401` — Unauthorized access to the requested resource.
- `404` — The resource was not found.

---

[API](https://skmtc.net/goodleap/apis/developer-api.md) · [All operations](https://skmtc.net/goodleap/apis/developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/goodleap/developer-api/revisions/0ba836de8da3/schema)