SLslopepay
Batch

Submit a batch operation for one or more customers

Ingest and process customer data asynchronously. The operation determines whether the request only stores data (INGEST), runs transaction enrichment (ENRICH), or runs full evaluation (EVALUATE) for the requested product: attributes (features, monthly financials, recurring cash flows), Slope Score, or both. Internally, evaluation requests are stored in S3 and Python is invoked with an S3 reference.

post/api/v1/batch

Request

  • Base URL
    https://slopeai.slopepay.com
  • URL
    https://slopeai.slopepay.com/api/v1/batch
  • Auth
    HTTP bearer

Headers

Idempotency-Keystring

Optional idempotency key for safely retrying batch submissions. Reusing the same key with an identical request body replays the original response; reusing it with a different body returns IDEMPOTENCY_MISMATCH (400). Keys expire after a TTL.

Example:batch-2026-01-01-001

Request body

OR

Example request

{
  "customers": [
    {
      "customer": {
        "customer_id": "cust_12345",
        "first_name": "John",
        "last_name": "Doe",
        "business_name": "Acme Corp"
      },
      "accounts": [
        {
          "account_id": "acc_001",
          "number_mask": "1234",
          "name": "Checking"
        }
      ],
      "balances": [
        {
          "account_id": "acc_001",
          "date": "2026-01-01T00:00:00Z",
          "current": 100000,
          "available": 95000,
          "currency": "usd"
        }
      ],
      "transactions": [
        {
          "transaction_id": "txn_001",
          "account_id": "acc_001",
          "description": "ACME CORP PAYMENT",
          "amount": -50000,
          "date": "2026-01-15T00:00:00Z",
          "authorized_date": "2026-01-14T00:00:00Z",
          "currency": "usd"
        }
      ]
    }
  ]
}

Response

Batch accepted for asynchronous processing

job_idstring required
operation'INGEST' | 'ENRICH' | 'EVALUATE' required

The processing operation to run

product'ATTRIBUTES' | 'SCORE' | 'ATTRIBUTES_AND_SCORE' | 'null' nullable required

The requested product; null for INGEST and ENRICH

Example response

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "items": [
    {
      "customer_id": "cust_12345",
      "errors": [
        {
          "code": "SCHEMA_VALIDATION",
          "message": "Invalid field value",
          "fields": [
            "accounts.0.account_id"
          ]
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.