---
title: "Read FPSL Loans Analytics for an Account"
method: GET
path: "/v1/fpsl/analytics/{account_id}/loans"
tags: ["FPSL Program"]
---

# Read FPSL Loans Analytics for an Account

`GET /v1/fpsl/analytics/{account_id}/loans`

Returns aggregated FPSL interest and loan-activity counts for one account over a date range. Use this for "earned so far this month" customer UIs and for supervisory spot-checks against your internal accrual model.

The `{account_id}` path parameter accepts a account UUID (aggregation for that account).

## Path parameters

- `account_id` string, uuid, required

## Query parameters

- `start` string, date
- `end` string, date

## Response `200`

Returns the aggregated FPSL loan analytics for the account.

- FPSLAnalyticsLoansResponse — Aggregated FPSL interest and loan-activity counts for one account over a date range.
  - `account_number` string, required — Account's number at Alpaca
  - `in_progress_lending_activities` integer, required — The number of FPSL lending activities currently in progress for the account.
  - `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.
  - `total_lending_activities` integer, required — The total number of FPSL lending activities for the account within the specified date range.

## 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)