---
title: "Retrieves a user history"
method: GET
path: "/user-histories/{address}"
tags: ["User Histories"]
---

# Retrieves a user history

`GET /user-histories/{address}`

## Path parameters

- `address` string, required

## Response `200`

User history for a specific address

- UserHistory
  - `events` union[]
    - union
      - BuyerExecutedLoan
        - `type` 'BUYER_EXECUTED_LOAN', required
        - `timestamp` integer, required
        - `loan` LoanStruct, required
          - `buyerNftId` string
          - `sellerNftId` string
          - `remainingPrincipal` string
          - `minimumPrincipalPerPeriod` string
          - `periodInterestRateBps` integer
          - `periodDuration` integer
          - `periodEndTimestamp` integer
          - `periodBeginTimestamp` integer
        - `txHash` string, required
      - UserSentBuyerNft
        - `type` 'SENT_BUYER_NFT', required
        - `timestamp` integer, required
        - `nftId` string, required
        - `to` string, required
        - `from` string, required
        - `txHash` string, required
      - UserReceivedBuyerNft
        - `type` 'RECEIVED_BUYER_NFT', required
        - `timestamp` integer, required
        - `nftId` string, required
        - `to` string, required
        - `from` string, required
        - `txHash` string, required
      - BuyerMadePayment
        - `type` 'BUYER_MADE_PAYMENT', required
        - `timestamp` integer, required
        - `loan` Loan, required
          - `loan` LoanStruct
            - `buyerNftId` string
            - `sellerNftId` string
            - `remainingPrincipal` string
            - `minimumPrincipalPerPeriod` string
            - `periodInterestRateBps` integer
            - `periodDuration` integer
            - `periodEndTimestamp` integer
            - `periodBeginTimestamp` integer
          - `offer` Offer
            - `offer` OfferStruct
              - …
            - `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[]
              - …
          - `sellerNft` NftDetails
            - `tokenId` string
            - `owner` string
            - `ownerHistory` string[]
            - `transferEvents` TransferEvent[]
              - …
          - `paymentHistory` unknown[]
            - unknown
          - `status` 'ACTIVE' | 'FULLY_REPAID' | 'ASSET_SEIZED'
          - `defaultStatus` 'NOT_IN_DEFAULT' | 'IN_DEFAULT_AND_REPAYABLE' | 'IN_DEFAULT_AND_NOT_REPAYABLE'
        - `amount` string, required
        - `interestPaid` string, required
        - `royaltiesPaid` string, required
        - `txHash` string, required
      - BuyerPaidOffLoan
        - `type` 'BUYER_PAID_OFF_LOAN', required
        - `timestamp` integer, required
        - `loan` Loan, required
          - `loan` LoanStruct
            - `buyerNftId` string
            - `sellerNftId` string
            - `remainingPrincipal` string
            - `minimumPrincipalPerPeriod` string
            - `periodInterestRateBps` integer
            - `periodDuration` integer
            - `periodEndTimestamp` integer
            - `periodBeginTimestamp` integer
          - `offer` Offer
            - `offer` OfferStruct
              - …
            - `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[]
              - …
          - `sellerNft` NftDetails
            - `tokenId` string
            - `owner` string
            - `ownerHistory` string[]
            - `transferEvents` TransferEvent[]
              - …
          - `paymentHistory` unknown[]
            - unknown
          - `status` 'ACTIVE' | 'FULLY_REPAID' | 'ASSET_SEIZED'
          - `defaultStatus` 'NOT_IN_DEFAULT' | 'IN_DEFAULT_AND_REPAYABLE' | 'IN_DEFAULT_AND_NOT_REPAYABLE'
        - `txHash` string, required
      - BuyerDefaultedOnLoan
        - `type` 'BUYER_DEFAULTED_ON_LOAN', required
        - `timestamp` integer, required
        - `loan` Loan, required
          - `loan` LoanStruct
            - `buyerNftId` string
            - `sellerNftId` string
            - `remainingPrincipal` string
            - `minimumPrincipalPerPeriod` string
            - `periodInterestRateBps` integer
            - `periodDuration` integer
            - `periodEndTimestamp` integer
            - `periodBeginTimestamp` integer
          - `offer` Offer
            - `offer` OfferStruct
              - …
            - `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[]
              - …
          - `sellerNft` NftDetails
            - `tokenId` string
            - `owner` string
            - `ownerHistory` string[]
            - `transferEvents` TransferEvent[]
              - …
          - `paymentHistory` unknown[]
            - unknown
          - `status` 'ACTIVE' | 'FULLY_REPAID' | 'ASSET_SEIZED'
          - `defaultStatus` 'NOT_IN_DEFAULT' | 'IN_DEFAULT_AND_REPAYABLE' | 'IN_DEFAULT_AND_NOT_REPAYABLE'
      - BuyerAssetSeized
        - `type` 'BUYER_ASSET_SEIZED', required
        - `timestamp` integer, required
        - `loan` Loan, required
          - `loan` LoanStruct
            - `buyerNftId` string
            - `sellerNftId` string
            - `remainingPrincipal` string
            - `minimumPrincipalPerPeriod` string
            - `periodInterestRateBps` integer
            - `periodDuration` integer
            - `periodEndTimestamp` integer
            - `periodBeginTimestamp` integer
          - `offer` Offer
            - `offer` OfferStruct
              - …
            - `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[]
              - …
          - `sellerNft` NftDetails
            - `tokenId` string
            - `owner` string
            - `ownerHistory` string[]
            - `transferEvents` TransferEvent[]
              - …
          - `paymentHistory` unknown[]
            - unknown
          - `status` 'ACTIVE' | 'FULLY_REPAID' | 'ASSET_SEIZED'
          - `defaultStatus` 'NOT_IN_DEFAULT' | 'IN_DEFAULT_AND_REPAYABLE' | 'IN_DEFAULT_AND_NOT_REPAYABLE'
        - `txHash` string, required
      - SellerCreatedOffer
        - `type` 'SELLER_CREATED_OFFERStruct', required
        - `timestamp` integer, required
        - `signature` string, required
        - `offer` Offer, required
          - `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
      - SellerCancelledOffer
        - `type` 'SELLER_CANCELLED_OFFERStruct', required
        - `timestamp` integer, required
        - `signature` string, required
        - `offer` Offer, required
          - `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
        - `txHash` string, required
      - SellerLoanExecuted
        - `type` 'SELLER_LOAN_EXECUTED', required
        - `timestamp` integer, required
        - `loan` LoanStruct, required
          - `buyerNftId` string
          - `sellerNftId` string
          - `remainingPrincipal` string
          - `minimumPrincipalPerPeriod` string
          - `periodInterestRateBps` integer
          - `periodDuration` integer
          - `periodEndTimestamp` integer
          - `periodBeginTimestamp` integer
        - `txHash` string, required
      - UserSentSellerNft
        - `type` 'SENT_SELLER_NFT', required
        - `timestamp` integer, required
        - `nftId` string, required
        - `to` string, required
        - `from` string, required
        - `txHash` string, required
      - UserReceivedSellerNft
        - `type` 'RECEIVED_SELLER_NFT', required
        - `timestamp` integer, required
        - `nftId` string, required
        - `to` string, required
        - `from` string, required
        - `txHash` string, required
      - SellerPaymentReceived
        - `type` 'SELLER_PAYMENT_RECEIVED', required
        - `timestamp` integer, required
        - `loan` Loan, required
          - `loan` LoanStruct
            - `buyerNftId` string
            - `sellerNftId` string
            - `remainingPrincipal` string
            - `minimumPrincipalPerPeriod` string
            - `periodInterestRateBps` integer
            - `periodDuration` integer
            - `periodEndTimestamp` integer
            - `periodBeginTimestamp` integer
          - `offer` Offer
            - `offer` OfferStruct
              - …
            - `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[]
              - …
          - `sellerNft` NftDetails
            - `tokenId` string
            - `owner` string
            - `ownerHistory` string[]
            - `transferEvents` TransferEvent[]
              - …
          - `paymentHistory` unknown[]
            - unknown
          - `status` 'ACTIVE' | 'FULLY_REPAID' | 'ASSET_SEIZED'
          - `defaultStatus` 'NOT_IN_DEFAULT' | 'IN_DEFAULT_AND_REPAYABLE' | 'IN_DEFAULT_AND_NOT_REPAYABLE'
        - `amount` string, required
        - `interestPaid` string, required
        - `royaltiesPaid` string, required
        - `txHash` string, required
      - SellerLoanPaidOff
        - `type` 'SELLER_LOAN_PAID_OFF', required
        - `timestamp` integer, required
        - `loan` Loan, required
          - `loan` LoanStruct
            - `buyerNftId` string
            - `sellerNftId` string
            - `remainingPrincipal` string
            - `minimumPrincipalPerPeriod` string
            - `periodInterestRateBps` integer
            - `periodDuration` integer
            - `periodEndTimestamp` integer
            - `periodBeginTimestamp` integer
          - `offer` Offer
            - `offer` OfferStruct
              - …
            - `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[]
              - …
          - `sellerNft` NftDetails
            - `tokenId` string
            - `owner` string
            - `ownerHistory` string[]
            - `transferEvents` TransferEvent[]
              - …
          - `paymentHistory` unknown[]
            - unknown
          - `status` 'ACTIVE' | 'FULLY_REPAID' | 'ASSET_SEIZED'
          - `defaultStatus` 'NOT_IN_DEFAULT' | 'IN_DEFAULT_AND_REPAYABLE' | 'IN_DEFAULT_AND_NOT_REPAYABLE'
        - `txHash` string, required
      - SellerLoanDefaultedOn
        - `type` 'SELLER_LOAN_DEFAULTED_ON', required
        - `timestamp` integer, required
        - `loan` Loan, required
          - `loan` LoanStruct
            - `buyerNftId` string
            - `sellerNftId` string
            - `remainingPrincipal` string
            - `minimumPrincipalPerPeriod` string
            - `periodInterestRateBps` integer
            - `periodDuration` integer
            - `periodEndTimestamp` integer
            - `periodBeginTimestamp` integer
          - `offer` Offer
            - `offer` OfferStruct
              - …
            - `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[]
              - …
          - `sellerNft` NftDetails
            - `tokenId` string
            - `owner` string
            - `ownerHistory` string[]
            - `transferEvents` TransferEvent[]
              - …
          - `paymentHistory` unknown[]
            - unknown
          - `status` 'ACTIVE' | 'FULLY_REPAID' | 'ASSET_SEIZED'
          - `defaultStatus` 'NOT_IN_DEFAULT' | 'IN_DEFAULT_AND_REPAYABLE' | 'IN_DEFAULT_AND_NOT_REPAYABLE'
      - SellerSeizedAsset
        - `type` 'SELLER_SEIZED_ASSET', required
        - `timestamp` integer, required
        - `loan` Loan, required
          - `loan` LoanStruct
            - `buyerNftId` string
            - `sellerNftId` string
            - `remainingPrincipal` string
            - `minimumPrincipalPerPeriod` string
            - `periodInterestRateBps` integer
            - `periodDuration` integer
            - `periodEndTimestamp` integer
            - `periodBeginTimestamp` integer
          - `offer` Offer
            - `offer` OfferStruct
              - …
            - `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[]
              - …
          - `sellerNft` NftDetails
            - `tokenId` string
            - `owner` string
            - `ownerHistory` string[]
            - `transferEvents` TransferEvent[]
              - …
          - `paymentHistory` unknown[]
            - unknown
          - `status` 'ACTIVE' | 'FULLY_REPAID' | 'ASSET_SEIZED'
          - `defaultStatus` 'NOT_IN_DEFAULT' | 'IN_DEFAULT_AND_REPAYABLE' | 'IN_DEFAULT_AND_NOT_REPAYABLE'
        - `txHash` string, required

---

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