---
title: "Get prescreens by customer ID"
method: GET
path: "/v4/prescreens"
tags: ["Prescreens"]
---

# Get prescreens by customer ID

`GET /v4/prescreens`

Get all prescreens by customer ID, most recent prescreen first.

## Query parameters

- `customerId` string, required

## Response `200`

The prescreens for the customer

- CustomerPrescreensV4ResponseDto
  - `prescreens` PrescreenEntityV4ResponseDto[], required — An array of prescreens for a customer
    - `id` string, required — ID of the prescreen
    - `customerId` string, required — Slope Customer ID
    - `status` 'pending' | 'succeeded' | 'failed', required — Status of the prescreen
    - `approvalLikelihood` string — Likelihood of approval: high, med, low
    - `limitCents` number — Evaluated limit of the prescreen, in cents
    - `bestAprPct` number — Best APR percentage, e.g 12.99
    - `reasons` PrescreenSharedDto[] — Reasons for the prescreen results
      - `code` string, required — The code of the reason
      - `message` string, required — The message of the reason
    - `expiresAt` string, date-time — When the prescreen expires, e.g 2025-01-01T00:00:00.000Z
    - `metadata` PrescreenMetadataSharedDto
      - `yearEstablished` number — Year of establishment of business
      - `expectedMonthlySpendingCents` number — Expected monthly spending in cents
      - `joinDateRangeDays` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `lastTransactionAmountRange` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `lastTransactionDateRange` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `totalSpending90DaysRange` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `totalSpending365DaysRange` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `totalPurchases90DaysRange` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `totalPurchases365DaysRange` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `growthLevel` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `smbNotVerified` boolean — SMB not verified status
      - `highValueCustomer` boolean — High value customer status
      - `purchasingDemandForecast6MonthsCents` number — Purchasing demand forecast for the next 6 months in cents
      - `buyerRiskLevelRange` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `buyerStickinessRange` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `buyerPurchasingStabilityRange` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `avgPurchaseIntervals365Range` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `avgPurchaseIntervals730Range` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `coefficientPurchaseIntervals365Range` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `coefficientPurchaseIntervals730Range` 'NA' | 'L0' | 'L1' | 'L2' | 'L3' | 'L4' | 'L5' | 'L6' | 'L7' | 'L8' | 'L9' | 'L10' | 'L11' — Join date range level
      - `externalTransactionId` string — The partner's transaction ID used to tie a prescreen to a specific transaction
      - `purchasingDemandFor6m` string — A temporary field in order to bypass field validation. This field is expected to be removed.

## Other responses

- `400` — Returned when improperly formatted or missing fields in request body
- `401` — Returned when improper keys or headers are used in the request
- `403` — Returned when the caller is not authorized to access the resource
- `500` — Returned when an internal server error occurs

---

[API](https://skmtc.net/slopepay/apis/slope-v4-api.md) · [All operations](https://skmtc.net/slopepay/apis/slope-v4-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/slopepay/slope-v4-api/versions/cbdbc861073b/schema)