---
title: "List FPSL Loans"
method: GET
path: "/v1/fpsl/loans"
tags: ["FPSL Program"]
---

# List FPSL Loans

`GET /v1/fpsl/loans`

Returns a list of all FPSL loans that match the specified filter criteria, ordered in ascending order by `date`, `account_number`, and `symbol`. Each entry represents a loan of a `symbol` on a given `date`, made on behalf of the specified `account_number`.

## Query parameters

- `account_id` string, uuid
- `start` string, date
- `end` string, date
- `page_token` string
- `limit` integer

## Response `200`

Returns a list of FPSL loans for the account, or an empty list if no loans are found.

- ListFPSLLoansResponse — Response to a successful request for a list of FPSL loans.
  - `loans` FPSLLoan[], required — All FPSL loans matching the filter criteria
    - `account_id` string, required — Account's ID at Alpaca
    - `account_number` string, required — Account's number at Alpaca
    - `collateral` number, double, required — The collateral posted for the loan.
    - `correspondent` string, required — Account's correspondent
    - `date` string, date, required
    - `interest` FPSLInterest — The interest's details. Please note that the object might not be set if interest has not yet been calculated for the loan. Additionally, interest details may be adjusted retroactively at any time until interests are finalized for the month. The loan's changed `updated_at` field can indicate such an adjustment.
      - `customer` number, double, required — The interest accrued by the customer for this loan.
      - `partner` number, double, required — The interest accrued by the partner for this loan.
    - `market_value` number, double, required — The total market value of the shares on loan.
    - `quantity` integer, required — The number of shares in the loan. This may be less than the total number of eligible shares held by the account.
    - `symbol` string, required — Stock/Ticker symbol of a stock or security
    - `updated_at` string, date-time — Timestamp of the last update to this loan in RFC-3339 format with microsecond precision with timezone. An updated value may indicate adjusted interest values.
  - `next_page_token` string, nullable, required — The token to use to retrieve the next page of results. If `null`, there are no more pages.

## Other responses

- `400` — One of the request parameters is invalid. See the returned message for details.
- `401` — Authentication headers are missing or invalid. Make sure you authenticate your request with a valid API key.
- `403` — User has no access to a resource.
- `500` — Internal server error. We recommend retrying these later. If the issue persists, please contact us on Slack or on the Community Forum.

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)