---
title: "Retrieve loans"
method: GET
path: "/loans"
tags: ["Loans"]
---

# Retrieve loans

`GET /loans`

This endpoint is used to retrieve a list of loans. When used without query params, it will fetch all loans. Query params can be used to filter this set.

## Query parameters

- `nftId` string
- `collection` string
- `seller` string
- `buyer` string

## Response `200`

A list of loans

- Loan[]
  - `loan` LoanStruct
    - `buyerNftId` string
    - `sellerNftId` string
    - `remainingPrincipal` string
    - `minimumPrincipalPerPeriod` string
    - `periodInterestRateBps` integer
    - `periodDuration` integer
    - `periodEndTimestamp` integer
    - `periodBeginTimestamp` integer
  - `offer` Offer
    - `offer` OfferStruct
      - `minimumPrincipalPerPeriod` string
      - `periodDuration` integer
      - `creator` string
      - `nftContractAddress` string
      - `price` string
      - `periodInterestRateBps` integer
      - `nftId` string
      - `expiration` integer
      - `downPaymentAmount` string
      - `collectionOfferLimit` string
    - `signature` string
    - `createdAt` integer
    - `status` 'ACTIVE' | 'EXPIRED' | 'CANCELLED' | 'USED_TO_EXECUTE_LOAN' | 'COLLECTION_OFFER_LIMIT_REACHED'
    - `isCollectionOffer` boolean
    - `howManyTimesUsed` integer
  - `buyerNft` NftDetails
    - `tokenId` string
    - `owner` string
    - `ownerHistory` string[]
    - `transferEvents` TransferEvent[]
      - `args` TransferEventArgs
        - `from` string
        - `to` string
        - `tokenId` string
      - `blockNumber` integer
      - `transactionHash` string
      - `transactionIndex` integer
      - `logIndex` integer
      - `eventType` 'Transfer'
  - `sellerNft` NftDetails
    - `tokenId` string
    - `owner` string
    - `ownerHistory` string[]
    - `transferEvents` TransferEvent[]
      - `args` TransferEventArgs
        - `from` string
        - `to` string
        - `tokenId` string
      - `blockNumber` integer
      - `transactionHash` string
      - `transactionIndex` integer
      - `logIndex` integer
      - `eventType` 'Transfer'
  - `paymentHistory` unknown[]
    - unknown
  - `status` 'ACTIVE' | 'FULLY_REPAID' | 'ASSET_SEIZED'
  - `defaultStatus` 'NOT_IN_DEFAULT' | 'IN_DEFAULT_AND_REPAYABLE' | 'IN_DEFAULT_AND_NOT_REPAYABLE'

## Other responses

- `400` — Bad request (invalid query)

---

[API](https://skmtc.net/niftyapes/apis/niftyapes-seller-financing-api.md) · [All operations](https://skmtc.net/niftyapes/apis/niftyapes-seller-financing-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/niftyapes/niftyapes-seller-financing-api/revisions/e3581eb2919f/schema)