Evaluate one customer synchronously

post

https://slopeai.slopepay.com/api/v1/evaluate

Stores the customer's accounts, balances, and transactions (same as POST /batch), then runs enrichment and evaluation inline and returns the evaluation. The evaluation uses the customer's full stored history, not only the transactions in this request. If it does not finish within 55 seconds, returns 504 EVALUATION_TIMEOUT with a job_id while processing continues; retry with the same Idempotency-Key to get the result.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

include_score is no longer supported; use product.

customer

object

required

accounts

array of objects

length ≤ 100

accounts

balances

array of objects

balances

transactions

array of objects

length ≤ 10000

Up to 10000 transactions; larger requests are rejected with REQUEST_TOO_LARGE (400) and should use POST /batch. Transactions are upserted by transaction_id; when a transaction_id repeats, the last occurrence wins.

transactions

product

string

enum

required

What an EVALUATE returns: cash flow attributes (features, monthly financials, and recurring cash flows), the Slope Score with its reasons, or both

Allowed:

Headers

Idempotency-Key

string

Optional idempotency key for safely retrying an evaluation. Reusing the same key with an identical request body returns the original evaluation (or EVALUATION_IN_PROGRESS while it is still running) without re-running it; reusing it with a different body returns IDEMPOTENCY_MISMATCH (400). Keys expire after a TTL.

Responses

200Evaluation for the customer

401Missing or invalid API key

409An earlier request with the same Idempotency-Key is still being evaluated (EVALUATION_IN_PROGRESS)

413Request JSON body exceeds the maximum byte size (REQUEST_TOO_LARGE); split it into smaller requests

500Unexpected server error

502Evaluation ran but failed (EVALUATION_FAILED)

504Evaluation did not finish within the deadline and is still running (EVALUATION_TIMEOUT)