---
title: Loan Originators API
description: Learn how to fetch and manage loan originator data using the Loan
  Originator API
---

Welcome to Figure's Loan Originator API guide. This documentation provides the necessary information for fetching loan originator data, including looking up originators by email or retrieving a paginated list.

{% callout type="note" %}

You must be onboarded before using the API. See [Partner onboarding](/partner-onboarding) to get set up, or [contact us](/contact) if you haven't started yet.

{% /callout %}

## Overview

The Loan Originator API allows you to retrieve loan originator information associated with your organization. It offers the following capabilities:

- **Fetch by Email:** Look up one or more loan originators by their email addresses.
- **Paginated Listing:** Retrieve a paginated list of all loan originators available to your organization.

## How it works

{% sequence %}
{% actor id="partner" label="Your system" kind="partner" /%}
{% actor id="figure" label="Figure" kind="figure" /%}
{% message from="partner" to="figure" label="List loan originators, optionally by email" endpoint="GET /management/v1/loan-originator" /%}
{% message from="figure" to="partner" reply=true label="Loan originators, with the UUID to use on each request" /%}
{% /sequence %}

## Fetch loan originators {% #fetch-loan-originators %}

Retrieve loan originator data by email address or with pagination. You can query for specific originators using the `email` parameter, or paginate through all available originators using `offset` and `limit`.

{% callout type="tip" %}
Optional fields in requests and responses are highlighted in green.
{% /callout %}

**Request**
```txt {% title="URL" %}
GET https://api.figure.com/management/v1/loan-originator
```

### Query parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string[] | No | One or more email addresses to filter loan originators by |
| `offset` | integer | No | Pagination offset (number of records to skip). Defaults to `0` |
| `limit` | integer | No | Maximum number of records to return. Defaults to `100` |

### Example request

```txt {% title="URL" %}
GET https://api.figure.com/management/v1/loan-originator?email=john.doe@example.com&limit=10&offset=0
```

**Response**
```json5 {% title="Response" %}
{
  "data": [
    {
      "loanOriginatorId": string,  // UUID format
      "email": string,
      "firstName": string,
      "lastName": string,
      // optional-start
      "middleName": string,
      "nmls": string,
      "phoneNumber": string,
      // optional-end
      "organization": string,
      // optional-start
      "brokerCompany": {
        "brokerId": string,  // UUID format
        "brokerName": string,
        "brokerNmls": string
      }
      // optional-end
    }
  ],
  "total": integer,  // total number of matching records
  "count": integer   // number of records in this response
}
```

## Response schema

### FetchLoanOriginatorsResponse

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `data` | LoanOriginatorData[] | Yes | Array of loan originator records |
| `total` | integer | Yes | Total number of matching loan originators |
| `count` | integer | Yes | Number of records returned in this response |

### LoanOriginatorData

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `loanOriginatorId` | string (UUID) | Yes | Unique identifier for the loan originator |
| `email` | string | Yes | Email address of the loan originator |
| `firstName` | string | Yes | First name |
| `lastName` | string | Yes | Last name |
| `middleName` | string | No | Middle name |
| `nmls` | string | No | NMLS identifier |
| `organization` | string | Yes | Organization name |
| `phoneNumber` | string | No | Phone number |
| `brokerCompany` | BrokerCompanyData | No | Associated broker company information |

### BrokerCompanyData

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brokerId` | string (UUID) | Yes | Unique identifier for the broker company |
| `brokerName` | string | Yes | Name of the broker company |
| `brokerNmls` | string | Yes | NMLS identifier for the broker company |