---
title: "Look Up Transactions by Creation Window"
method: GET
path: "/v1/payments/transactions/lookup"
tags: ["Transactions"]
---

# Look Up Transactions by Creation Window

`GET /v1/payments/transactions/lookup`

## Request

- Base URL: `https://sandbox-api.spinwheel.io`
- URL: `https://sandbox-api.spinwheel.io/v1/payments/transactions/lookup`
- Auth: API key in header `Authorization`

This API will allow you to get the current status of all transactions created after a timestamp, optionally filtered by status. Results are returned in pages of 100. Pass the nextCursor from a response as cursor to get the next page.

## Query parameters

- `createdAfter` number
- `statuses` string[]
- `cursor` string

## Response `200`

Successful response

- LookupTransactionsResponse
  - `nextCursor` string, nullable, required: Pass as cursor to get the next page. null on the last page.
  - `status` ResponseStatus, required
    - `code` number
    - `desc` string
    - `messages` Message[]
      - `desc` string, required
      - `type` 'ERROR' | 'WARN' | 'INFO'
  - `data` GetPaymentTransactionsData[], required
    - `userId` string: User Id of the user towards whom payment was scheduled
    - `payerId` string: Payer Id towards whom payment was scheduled
    - `requestId` string: Request Id received on creating the payment request
    - `extRequestId` string: External Request Id sent on creating a payment request
    - `status` 'SCHEDULING_REVIEW' | 'SCHEDULING' | 'PROCESSING' | 'PROCESSING_REVIEW' | 'SCHEDULED' | 'SCHEDULING_RETRY' | 'APPLIED' | 'FAILED' | 'SCHEDULED_REVIEW_REQUIRED' | 'CANCELLED' | 'RETURNED': Transaction status
    - `statusComment` string: Status comment
    - `paymentStatusCode` string: Payment status code
    - `errorDescription` string
    - `paymentTraceNumber` string
    - `scheduleTs` number: Timestamp of when the transaction was scheduled
    - `amount` number: Transaction amount
    - `createdOn` number
    - `updatedOn` number
    - `transactionId` string, required: Spinwheel generated Transaction Id.
    - `settlementAccountId` string: Settlement Account Id associated with the transaction.
    - `useOfFunds` union
      - AllocationHomeLoan
        - `homeLoanId` string, required: Spinwheel generated home loan id of the loan you're posting the payment to.
        - `percentage` number, required: Percentage of the amount you're posting towards the loan.
        - `liabilityType` 'HOME_LOAN': Type of liability towards which the useOfFunds is allocated.
      - AllocationCreditCard
        - `creditCardId` string, required: Spinwheel generated credit card id of cards you're posting the payment to.
        - `percentage` number, required: Percentage of the amount you're posting towards the card.
        - `liabilityType` 'CREDIT_CARD': Type of liability towards which the useOfFunds is allocated.
      - AllocationPersonalLoan
        - `personalLoanId` string, required: Spinwheel generated loan id of personal loan you're posting the payment to
        - `percentage` number, required: Percentage of the amount you're posting towards the loan.
        - `liabilityType` 'PERSONAL_LOAN': Type of liability towards which the useOfFunds is allocated.
      - AllocationAutoLoan
        - `autoLoanId` string, required: Spinwheel generated loan id of the auto loan you're posting the payment to
        - `percentage` number, required: Percentage of the amount you're posting towards the loan.
        - `liabilityType` 'AUTO_LOAN': Type of liability towards which the useOfFunds is allocated.
      - AllocationStudentLoan
        - `studentLoanId` string, required: Spinwheel generated student loan id of the loan you're posting the payment to.
        - `percentage` number, required: Percentage of the amount you're posting towards the loan.
        - `liabilityType` 'STUDENT_LOAN': Type of liability towards which the useOfFunds is allocated.
      - AllocationTransactionDirectStudentLoan
        - `liabilityType` 'STUDENT_LOAN': Type of liability towards which the useOfFunds is allocated.
        - `loanAccountId` string: Spinwheel generated loan account id of the loan you're posting the payment to.
        - `loanServicerId` string: Spinwheel generated loan servicer id of the loan you're posting the payment to.
        - `percentage` number: Percentage of the amount you're posting towards the loan.
        - `applyTowardsStatement` boolean: Whether or not the additional payment made is applied to the statement
        - `loans` AllocationLoans[]
          - `loanId` string, required: Spinwheel generated loan id of the loan you're posting the payment to
          - `percentage` number, required: Percentage of the amount you're posting towards the loan.

## Other responses

- `400`: Bad request response
- `401`: Unauthorized response
- `404`: Not found response
- `500`: Internal server error response

---

[API](https://skmtc.dev/spinwheel/apis/pay.md) - [All operations](https://skmtc.dev/spinwheel/apis/pay/llms.txt) - [OpenAPI document](https://skmtc.dev/spinwheel/apis/pay/revisions/58ba91f8ae13?raw)