---
title: "List licenses, one row each"
method: GET
path: "/loan-officers/licenses"
tags: ["Loan officers"]
---

# List licenses, one row each

`GET /loan-officers/licenses`

## Request

- Base URL: `https://app.payna.com/api/v1`
- URL: `https://app.payna.com/api/v1/loan-officers/licenses`
- Auth: HTTP bearer

Returns every loan officer license as a flat row that includes the officer, for loading into a spreadsheet or BI tool. This endpoint is not paginated: one call returns every row.

Pass `format=csv` to receive a CSV file instead of JSON.

## Query parameters

- `state` string
- `can_originate` boolean
- `include_departed` boolean
- `format` 'json' | 'csv'

## Response `200`

Every license row.

- object
  - `data` LoanOfficerLicenseRow[]
    - `officer_id` string, uuid
    - `officer_nmls_id` string, nullable
    - `officer_name` string
    - `officer_email` string, nullable
    - `employment_status` string, nullable
    - `state` string
    - `license_name` string, nullable
    - `license_number` string, nullable
    - `nmls_status` string, nullable
    - `can_originate` boolean
    - `temporary_authority` boolean
    - `sponsorship` string, nullable
    - `sponsorship_nmls_status` string, nullable
    - `sponsored_since` string, date, nullable
    - `sponsorship_requested_on` string, date, nullable
    - `open_items` integer: How many items NMLS still wants for this license.
    - `renewal_due` string, date, nullable
    - `last_synced_at` string, date-time, nullable: When Payna last read this license from NMLS.
  - `meta` Meta
    - `total` integer
    - `page` integer
    - `limit` integer
    - `synced_at` string, date-time, nullable

## Other responses

- `400`: Invalid query parameter. The message names it.
- `401`: Missing or invalid API key.
- `403`: The API key lacks the `individuals` capability.
- `429`: Rate limit exceeded. Retry after the seconds in `Retry-After`.
- `500`: Error on Payna's side. Retry the request.

---

[API](https://skmtc.dev/payna/apis/payna-compliance-api.md) - [All operations](https://skmtc.dev/payna/apis/payna-compliance-api/llms.txt) - [OpenAPI document](https://skmtc.dev/payna/apis/payna-compliance-api/revisions/11ef1636c05a?raw)