Skip to main content
GET
/
applications
/
{applicationId}
cURL
curl --request GET \
  --url https://app.loanscape.io/api/v1.0/applications/{applicationId} \
  --header 'X-API-KEY: <api-key>'
{
  "applicationId": "<string>",
  "status": "<string>",
  "tag": "<string>",
  "channels": [
    {
      "title": "<string>",
      "status": "<string>",
      "dateApplied": "<string>",
      "dateApproved": "<string>",
      "dateRenewed": "<string>",
      "dateStatusUpdated": "<string>",
      "yearlyRenewalDate": "<string>"
    }
  ],
  "assignedAccountExecutive": {
    "userId": "<string>",
    "name": "<string>",
    "email": "<string>",
    "phone": "<string>"
  },
  "assignedUsers": [
    {
      "userId": "<string>",
      "name": "<string>",
      "email": "<string>",
      "phone": "<string>"
    }
  ],
  "nextRenewalDate": "<string>",
  "dateCreated": "<string>",
  "dateApproved": "<string>",
  "dateRenewed": "<string>",
  "dateStatusUpdated": "<string>",
  "tpo": {
    "companyId": "<string>",
    "name": "<string>",
    "nmls": "<string>",
    "address": {
      "line1": "<string>",
      "line2": "<string>",
      "city": "<string>",
      "state": "<string>",
      "zip": "<string>"
    },
    "phone": "<string>",
    "businessStructure": "<string>",
    "ein": "<string>",
    "stockSymbol": "<string>",
    "ncua": "<string>",
    "fdic": "<string>",
    "pointOfContact": {
      "userId": "<string>",
      "name": "<string>",
      "email": "<string>",
      "phone": "<string>"
    },
    "team": [
      {
        "userId": "<string>",
        "name": "<string>",
        "email": "<string>",
        "phone": "<string>",
        "roles": [
          "<string>"
        ],
        "isAuthorizedSigner": true
      }
    ],
    "suretyBonds": [
      {
        "company": "<string>",
        "amount": 123,
        "states": [
          "<string>"
        ],
        "expiryDate": "<string>"
      }
    ],
    "eoInsurance": [
      {
        "company": "<string>",
        "amount": 123,
        "states": [
          "<string>"
        ],
        "expiryDate": "<string>"
      }
    ],
    "affiliations": [
      {
        "affiliationType": "<string>",
        "companyName": "<string>",
        "address": {
          "line1": "<string>",
          "line2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "zip": "<string>"
        },
        "stateOfIncorporation": "<string>",
        "stateOfOperation": "<string>",
        "percentOwnership": 123
      }
    ],
    "industryApprovals": {
      "fha": "<string>",
      "va": "<string>",
      "fannieMae": "<string>",
      "freddieMac": "<string>",
      "ginnieMae": "<string>",
      "mers": "<string>",
      "usda": "<string>"
    }
  },
  "licensing": {
    "tradeNames": [
      {
        "name": "<string>",
        "states": [
          "<string>"
        ]
      }
    ],
    "licensedStates": [
      "<string>"
    ],
    "stateLicenses": [
      {
        "licenseId": "<string>",
        "licenseType": "<string>",
        "licenseNumber": "<string>",
        "status": "<string>",
        "regulator": "<string>",
        "state": "<string>",
        "issueDate": "<string>",
        "statusDate": "<string>"
      }
    ],
    "processors": [
      {
        "name": "<string>",
        "email": "<string>",
        "phone": "<string>",
        "isContractProcessor": true,
        "nmls": "<string>"
      }
    ],
    "loanOfficers": [
      {
        "nmls": "<string>",
        "name": "<string>",
        "email": "<string>",
        "phone": "<string>",
        "otherNames": [
          "<string>"
        ],
        "licensedStates": [
          "<string>"
        ],
        "stateLicenses": [
          {
            "licenseId": "<string>",
            "licenseType": "<string>",
            "licenseNumber": "<string>",
            "status": "<string>",
            "regulator": "<string>",
            "state": "<string>",
            "issueDate": "<string>",
            "statusDate": "<string>"
          }
        ],
        "federalRegistrations": [
          {
            "registrationId": "<string>",
            "regulator": "<string>",
            "statusDate": "<string>"
          }
        ],
        "locations": [
          {
            "locationType": "<string>",
            "nmls": "<string>",
            "address": {
              "line1": "<string>",
              "city": "<string>",
              "state": "<string>",
              "zip": "<string>"
            },
            "startDate": "<string>"
          }
        ],
        "missingFromNmls": true
      }
    ],
    "branches": [
      {
        "nmls": "<string>",
        "address": {
          "line1": "<string>",
          "line2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "zip": "<string>"
        },
        "managers": [
          {
            "name": "<string>",
            "nmls": "<string>"
          }
        ],
        "tradeNames": [
          {
            "name": "<string>",
            "states": [
              "<string>"
            ]
          }
        ],
        "licensedStates": [
          "<string>"
        ],
        "stateLicenses": [
          {
            "licenseId": "<string>",
            "licenseType": "<string>",
            "licenseNumber": "<string>",
            "status": "<string>",
            "regulator": "<string>",
            "state": "<string>",
            "issueDate": "<string>",
            "statusDate": "<string>"
          }
        ]
      }
    ]
  }
}

Authorizations

X-API-KEY
string
header
required

Path Parameters

applicationId
string
required

The applicationId of the application to fetch.

Query Parameters

fields
string

Additional fields to fetch. Separate multiple fields with commas. (optional)

Response

Application data returned.

applicationId
string

The application's unique identifier.

status
string

The status of the application: pending, active, pending_renewal, deactivated, denied or withdrawn.

tag
string

The tag assigned by the lender's team.

channels
object[]

The status and details of each channel associated with the application.

assignedAccountExecutive
object

Details of the assigned account executive on the lender's team.

assignedUsers
object[]

Details of the assigned users on the lender's team.

nextRenewalDate
string

The date that the next yearly document is due from the TPO. Only available for applications with status active or pending_renewal.

dateCreated
string

The date that the application was created. This is an ISO string (e.g. 2011-10-05T14:48:00.000Z).

dateApproved
string

The date that the application was first approved. This is an ISO string (e.g. 2011-10-05T14:48:00.000Z). (On the Loanscape website, the date shown under the "Date Approved" column will be either dateApproved or dateRenewed, whichever is latest. In the API, this is strictly the date of initial approval.)

dateRenewed
string

The date that the application was last renewed. If this is present, or if an application has status pending_renewal, it is a renewal application. This is an ISO string (e.g. 2011-10-05T14:48:00.000Z).

dateStatusUpdated
string

The date that the application's status was last updated (for example, renewed or deactivated). This is an ISO string (e.g. 2011-10-05T14:48:00.000Z).

tpo
object

Details of the TPO's company.

licensing
object

Licensing information for the TPO, their branches and their individuals - synced with NMLS. Access to licensing information is a premium feature - contact the Loanscape team to confirm that you have access.

I