---
title: "Get the latest evaluation for a customer"
method: GET
path: "/api/v1/customers/{customer_id}/evaluate"
tags: ["Customers"]
---

# Get the latest evaluation for a customer

`GET /api/v1/customers/{customer_id}/evaluate`

## Request

- Base URL: `https://slopeai.slopepay.com`
- URL: `https://slopeai.slopepay.com/api/v1/customers/{customer_id}/evaluate`
- Auth: HTTP bearer

Returns the latest completed evaluation for the customer. Its `product` decides what is returned: ATTRIBUTES returns attributes, monthly financials, and recurring cash flows with a null `slope_score`; SCORE returns only `slope_score` (score and reasons); ATTRIBUTES_AND_SCORE returns both.

## Path parameters

- `customer_id` string, required: Customer identifier

## Response `200`

Latest evaluation for the customer

- EvaluateResponse
  - `id` string, required
  - `customer_id` string, required
  - `as_of` string, date-time, required: Timestamp at which this evaluation was computed
  - `data_window_start` string, nullable, required: Start date of the data window used for evaluation
  - `data_window_end` string, nullable, required: End date of the data window used for evaluation
  - `model_version` string, nullable, required: Version of the evaluation model used
  - `features_version` string, nullable, required: Version of the features schema
  - `product` 'ATTRIBUTES' | 'SCORE' | 'ATTRIBUTES_AND_SCORE', required: The product this evaluation was requested with; it decides which of the fields below are returned
  - `slope_score` SlopeScore, nullable, required: Slope Score and reasons. Null when product is ATTRIBUTES.
    - `score` number, nullable, required
    - `version` string, nullable, required
    - `reasons` ScoreReason[], required
      - `code` string, required
      - `description` string, required
  - `features` object, nullable, required: Cash flow attributes used for evaluation. Null when product is SCORE.
  - `financials` MonthlyFinancials[], nullable: Monthly financials. Null when product is SCORE.
    - `month` string, required
    - `income_statement` object
    - `cashflow_statement` object
  - `recurring_cashflows` RecurringCashflow[], nullable: Recurring cash flow groupings derived from enriched transactions across accounts for this customer. Null when product is SCORE.
    - `counterparty` string, required
    - `start_date` string, required
    - `end_date` string, required
    - `transaction_count` integer, required
    - `total_amount` integer, required
    - `avg_amount` integer, required
    - `is_recurring` boolean, required
    - `recurrence_strength` number, nullable
    - `periodicity_days` number, nullable
    - `periodicity` string, nullable
    - `next_expected_transaction` string, nullable
    - `status` string, required
    - `example_transaction` string, nullable

## Other responses

- `401`: Missing or invalid API key
- `404`: Customer not found or no completed evaluations exist yet for this customer
- `500`: Unexpected server error

---

[API](https://skmtc.dev/slopepay/apis/slopeai-api.md) - [All operations](https://skmtc.dev/slopepay/apis/slopeai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/slopepay/apis/slopeai-api/revisions/c3a6761e9639?raw)