Cleo AI 数据 API：接口与字段

Cleo AI · 信贷

Cleo AI: Cash Advance & Money 是 Cleo AI 面向美国消费者推出的对话式个人理财应用，帮助用户管理日常开支和两次发薪之间的资金缺口。会员通过 Plaid 关联银行账户，查看余额和已分类的消费，设置 Smart Budget，追踪周期性账单与收入，并管理自动储蓄目标。Cover 提供工资预支功能，Cleo+ 则把预支额度、信用监控和返现整合在一起。应用还内置由 Equifax 提供支持的信用分追踪与改善建议、带徽章的 Cleo Score、由 Dwolla 驱动的返现钱包，以及信用养成卡的候补名单。在美国的现金预支与理财管理市场中，它与 Dave、EarnIn、Brigit、MoneyLion 和 Albert 同属一个竞争阵营。

Cover 资格记录把 possible-loan-amounts、unlockable-amount 和 badge-unlockable-amount 与 ineligible-reason、eligible-reason 配对。预支服务侧再加上 amount-formatted、repayment-date 和 disbursement-status，而催收记录则把 repayment_date 与 last_repayment_attempt_date、last_repayment_failure_reason 区分开。借贷与服务团队可以借助这些区分，在自己的视图里把资格、放款与还款状态分开呈现。

关联银行记录把 account-balance、formatted-account-balance 和 consent-expires-at 与交易级的 formatted-amount、merchant、corrected-made-on 合在一起。预期账单与收入以 next-payment-expected 为锚点，支出账单用 schedule，入账收入用 frequency。Smart Budget 周期提供以 transaction-category-id 为键的 category-budgets，让家庭现金规划工具能把支出上限与即将到来的义务和收入对齐。

信用辅导把 score 和 score-range-name 与 Equifax 因子标识（如 equifax_reason_code）以及 cleo_recommendation 中的建议结合起来。独立的 Cleo Score 提供覆盖账单、储蓄、信用和预算的 breakdown，而钱包记录则把现金 formatted-balance 与奖励积分区分开。这些字段组支撑现金流监控、预支服务和信用教育类对接；openData Studio 把它们做成可调用的开放数据。下方的 API 路径和示例均为示意性的合成内容，并非官方服务地址。

应用截图

API 端点一览

以下端点与请求/响应示例均依据应用界面推导重构，为示意说明，并非实际抓包。

开启移动端会话
POST /v1/session/handshake osint
在应用启动时开启 Android 会话，返回 csrfToken 与 authenticated，使后续的 Cover、银行和预算调用能够携带 _cleo_session 与 X-CSRF-Token。
认证方式：无需鉴权的会话引导，请求携带 device_token、platform 以及可选的 deep_link_params。响应提供 csrfToken，供后续写入请求放入 X-CSRF-Token，并建立 _cleo_session Cookie。
- device_token
- platform
- deep_link_params
- authenticated
- csrfToken
```
POST /v1/session/handshake HTTP/1.1
Content-Type: application/json

{
  "device_token": "<device-token>",
  "platform": "android",
  "deep_link_params": null
}
```
```
{
  "authenticated": true,
  "csrfToken": "<csrf-token>"
}
```

读取已登录用户资料

GET /v1/member/profile osint

加载已登录会员的姓名、邮箱、美国地址、currency-code、invite-code，以及控制 Cover、信用分和 Smart Budget 是否可用的 enabled-features。

认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。

first-name
last-name
email
phone-number
date-of-birth
intercom-user-id
currency-code
invite-code
auto-save-enabled
enabled-features
us-state
postcode

GET /v1/member/profile HTTP/1.1
Cookie: _cleo_session=<session>
Authorisation: Bearer <token>

{
  "data": {
    "id": "usr_8f21",
    "type": "users",
    "attributes": {
      "first-name": "Alex",
      "last-name": "Rivera",
      "email": "[email protected]",
      "phone-number": "+15555550114",
      "date-of-birth": "1994-06-12",
      "intercom-user-id": "int_19c",
      "currency-code": "USD",
      "time-zone": "America/New_York",
      "invite-code": "CLEO-ALEX",
      "auto-save-enabled": true,
      "enabled-features": [
        "cover",
        "credit_score",
        "smart_budget"
      ],
      "line-1": "12 Market St",
      "city": "Austin",
      "us-state": "TX",
      "postcode": "78701"
    }
  }
}

列出已关联银行登录与余额

GET /v1/banking/connections openbanking

返回通过 Plaid 关联的银行登录，附带每个账户的 formatted-balance，以及用于首页现金卡片的 meta account-balance 汇总。

认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。

provider-name
provider-code
display-status
consent-expires-at
account-balance
formatted-account-balance
bank-accounts-balance
transaction-count
account-name
formatted-balance

GET /v1/banking/connections?include=accounts HTTP/1.1
Cookie: _cleo_session=<session>

{
  "data": [
    {
      "id": "login_3a1",
      "type": "logins",
      "attributes": {
        "provider-name": "Chase",
        "provider-code": "ins_3",
        "display-status": "active",
        "transaction-count": 842,
        "consent-expires-at": "2026-12-01T00:00:00Z",
        "reconnect-url": null
      }
    }
  ],
  "meta": {
    "account-balance": "1240.55",
    "formatted-account-balance": "$1,240.55",
    "transaction-count": 842,
    "bank-accounts-balance": "1180.12"
  },
  "included": [
    {
      "id": "acc_chk",
      "type": "accounts",
      "attributes": {
        "account-name": "Everyday checking",
        "formatted-balance": "$1,180.12"
      }
    }
  ]
}

分页读取已分类银行交易

GET /v1/banking/entries openbanking

分页返回消费流水，带有 merchant、transaction-category、formatted-amount 与 corrected-made-on，供交易页面和 Spendr 聊天卡片使用。

认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。

amount
formatted-amount
full-description
display-group
corrected-made-on
marked-as-duplicate
transaction-category
merchant

GET /v1/banking/entries?include=transaction_category,merchant&page[size]=300 HTTP/1.1
Cookie: _cleo_session=<session>

{
  "data": [
    {
      "id": "txn_91c",
      "type": "transactions",
      "attributes": {
        "amount": "-42.18",
        "formatted-amount": "$42.18",
        "full-description": "UBER   TRIP",
        "display-group": "spending",
        "corrected-made-on": "2026-10-18",
        "marked-as-duplicate": false
      },
      "relationships": {
        "transaction-category": {
          "data": {
            "id": "cat_food",
            "type": "transaction_categories"
          }
        },
        "merchant": {
          "data": {
            "id": "m_uber",
            "type": "merchants"
          }
        },
        "account": {
          "data": {
            "id": "acc_chk",
            "type": "accounts"
          }
        }
      }
    }
  ]
}

读取每日滚动余额
GET /v1/cashflow/daily-balances openbanking
返回 start_date 与 end_date 之间以日期为键的支票账户滚动余额映射，用于现金流图表。
认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。
- start_date
- end_date
- date
- balance
```
GET /v1/cashflow/daily-balances?start_date=2026-10-01&end_date=2026-10-26 HTTP/1.1
Cookie: _cleo_session=<session>
```
```
{
  "2026-10-01": "980.10",
  "2026-10-15": "1240.55",
  "2026-10-26": "1104.22"
}
```

获取 Cover 资格快照

GET /v1/advance/eligibility openfinance

运行 Cover 授信任务，并为工资预支页面返回 possible-loan-amounts、unlockable-amount 和 ineligible-reason。

认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。资格评估是异步进行的；会持续检查对应的任务，直到得出决定。

eligible
possible-loan-amounts
unlockable-amount
badge-unlockable-amount
classifier-suggested-amounts
ineligible-reason
eligible-reason

GET /v1/advance/eligibility HTTP/1.1
Cookie: _cleo_session=<session>

{
  "data": {
    "id": "job_44e",
    "type": "eligibility_jobs"
  },
  "payload": {
    "extra": {
      "eligible": true,
      "possible-loan-amounts": [
        20,
        50,
        80,
        100
      ],
      "unlockable-amount": 50,
      "badge-unlockable-amount": 20,
      "classifier-suggested-amounts": [
        50,
        80
      ],
      "ineligible-reason": null,
      "eligible-reason": "income_detected"
    }
  }
}

读取当前 Cover / 工资预支状态

GET /v1/advance/overview openfinance

加载 Cover 处于 sticky-eligibility、active-loan 还是 cool-off 状态，并带上用于预支卡片的 amount-formatted、repayment-date 和 disbursement-status。

认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。

state
amount-formatted
expires-at
days-till-due
days-overdue
due-soon
repayment-date
disbursement-status
express
end-at-formatted

GET /v1/advance/overview HTTP/1.1
Cookie: _cleo_session=<session>

{
  "data": {
    "id": "odc_1",
    "type": "advance_overviews",
    "attributes": {
      "state": "active-loan",
      "sticky-eligibility": null,
      "active-loan": {
        "amount-formatted": "$80.00",
        "days-till-due": 6,
        "days-overdue": 0,
        "due-soon": true,
        "repayment-date": "2026-11-01",
        "disbursement-status": "completed",
        "express": false
      },
      "cool-off": null
    }
  }
}

读取 Cover 还款状态
GET /v1/advance/collections openfinance
返回 Cover 的催收状态（no_active_loan、not_due、last_repayment_failed、partially_repaid）以及用于历史弹窗的 repayment_date。
认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。
- status
- repayment_date
- last_repayment_attempt_date
- last_repayment_failure_reason
```
GET /v1/advance/collections HTTP/1.1
Cookie: _cleo_session=<session>
```
```
{
  "status": "not_due",
  "repayment_date": "2026-11-01",
  "last_repayment_attempt_date": null,
  "last_repayment_failure_reason": null
}
```

读取当前 Equifax 信用分

GET /v1/credit/report opendata

返回当前 Equifax 信用分、score-range-name，以及信用分页面展示的每个因子对应的 equifax_reason_code 文案。

认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。需要开通信用分功能。

score
score-range-name
score-ranges
generated-at
equifax_reason_code
equifax_description
equifax_factor_effect
cleo_header
cleo_recommendation

GET /v1/credit/report HTTP/1.1
Cookie: _cleo_session=<session>

{
  "data": {
    "id": "cs_2026_10",
    "type": "credit_scores",
    "attributes": {
      "score": 642,
      "score-range-name": "fair",
      "generated-at": "2026-10-12T08:01:00Z",
      "score-ranges": [
        {
          "name": "poor",
          "min": 300,
          "max": 579
        },
        {
          "name": "fair",
          "min": 580,
          "max": 669
        }
      ],
      "score-reasons": [
        {
          "equifax_reason_code": "38",
          "equifax_description": "Serious delinquency",
          "equifax_factor_effect": "negative",
          "cleo_header": "Late payments",
          "cleo_description": "A collection is still reporting.",
          "cleo_recommendation": "Bring past-due accounts current."
        }
      ]
    }
  }
}

列出返现钱包

GET /v1/cashback/accounts openfinance

列出 Dwolla 返现钱包，附带 balance、formatted-balance 以及 suspended/active 标记，供钱包页面使用。

认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。

currency
balance
formatted-balance
suspended
active

GET /v1/cashback/accounts?include_inactive=true HTTP/1.1
Cookie: _cleo_session=<session>

{
  "data": [
    {
      "id": "wal_usd",
      "type": "wallets",
      "attributes": {
        "currency": "USD",
        "balance": "12.40",
        "formatted-balance": "$12.40",
        "suspended": false,
        "active": true
      }
    }
  ]
}

读取 Smart Budget 与分类上限

GET /v1/planning/category-limits opendata

返回当前 Smart Budget 周期以及每个类别的金额上限（transaction-category-id、emoji），用于预算图表。

认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。

amount
start-date
end-date
current
category-budgets
transaction-category-id
name
emoji

GET /v1/planning/category-limits?include=category_budgets HTTP/1.1
Cookie: _cleo_session=<session>

{
  "data": [
    {
      "id": "sb_oct",
      "type": "smart_budgets",
      "attributes": {
        "amount": "1800.00",
        "start-date": "2026-10-01",
        "end-date": "2026-10-31",
        "current": true,
        "category-budgets": [
          {
            "id": "cb_food",
            "amount": "350.00",
            "transaction-category-id": 14,
            "name": "Eating out",
            "emoji": "",
            "color": "#FF6B4A"
          }
        ]
      }
    }
  ]
}

列出识别出的周期性账单

GET /v1/planning/obligations opendata

列出支出类周期性账单，附带 display-amount、next-payment-expected 和 schedule，供账单日历使用。

认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。

description
amount
display-amount
next-payment-expected
schedule
merchant

GET /v1/planning/obligations HTTP/1.1
Cookie: _cleo_session=<session>

{
  "data": [
    {
      "id": "bill_netflix",
      "type": "recurring_out",
      "attributes": {
        "description": "STREAMING SUBSCRIPTION",
        "amount": "15.49",
        "display-amount": "$15.49",
        "next-payment-expected": "2026-11-04",
        "schedule": "monthly",
        "icon": "tv"
      }
    }
  ]
}

列出识别出的周期性收入

GET /v1/planning/paychecks opendata

列出入账的工资收入，附带 formatted-amount、next-payment-expected 和 frequency，用于估算 Cover 额度和收入页面。

认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。

description
amount
formatted-amount
next-payment-expected
frequency
merchant

GET /v1/planning/paychecks HTTP/1.1
Cookie: _cleo_session=<session>

{
  "data": [
    {
      "id": "inc_payroll",
      "type": "recurring_in",
      "attributes": {
        "description": "ACME PAYROLL",
        "amount": "1840.00",
        "formatted-amount": "$1,840.00",
        "next-payment-expected": "2026-11-01",
        "frequency": "biweekly"
      }
    }
  ]
}

读取 Cleo Score 分项

GET /v1/wellbeing/scorecard opendata

返回应用内的 Cleo Score、max、status 以及各支柱的 breakdown，这些数据驱动徽章和 Cover 解锁额度。

认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。需要开通 Cleo Score 功能。

score
max
status
breakdown

GET /v1/wellbeing/scorecard HTTP/1.1
Cookie: _cleo_session=<session>

{
  "data": {
    "id": "score_usr_8f21",
    "type": "cleo_scores",
    "attributes": {
      "score": 64,
      "max": 100,
      "status": "good",
      "breakdown": {
        "bills": 18,
        "savings": 12,
        "credit": 20,
        "budget": 14
      }
    }
  }
}

读取返现奖励钱包余额
GET /v1/cashback/point-ledger/current openfinance
返回奖励钱包卡片上显示的当前返现积分余额。
认证方式：会话 Cookie（_cleo_session），或 Authorisation: Bearer <token>。需要开通奖励功能。
- balance
```
GET /v1/cashback/point-ledger/current HTTP/1.1
Cookie: _cleo_session=<session>
```
```
{
  "data": {
    "id": "rw_usr_8f21",
    "type": "reward_wallets",
    "attributes": {
      "balance": 2400
    }
  }
}
```

数据类别

余额
交易
现金预支
信用分
预算
账单
收入
奖励

数据使用场景与案例

Cover 授信结果回放
借贷系统可以从 Cover 快照中读取 possible-loan-amounts、unlockable-amount 和 ineligible-reason，再把进行中预支的 amount-formatted 与 disbursement-status 同 repayment_date 对账，让服务团队判断下一次扣款是 not_due 还是 last_repayment_failed。
关联银行现金流监控
个人理财工具或催收机器人可以读取 meta 中的 account-balance 和每个登录下的 formatted-balance，分页获取已分类交易（formatted-amount、merchant、corrected-made-on），再叠加 running_balance 日期映射，在下一次 Cover 放款之前标出现金偏低的时间窗口。
信用因子辅导信息流
信用教育界面可以从当前信用分结果中取出 score、score-range-name 以及每组 equifax_reason_code / cleo_recommendation，再结合 Cleo Score 的分项（breakdown），排出下一步最值得推动的习惯（账单、储蓄或预算）。
账单与收入日历
家庭现金规划工具可以合并 recurring/out 的 display-amount、next-payment-expected 与 recurring/in 的 frequency、formatted-amount，再按当前周期的 Smart Budget category-budgets 裁剪这些日期。

常见问题

这些是 Cleo 的真实线上 API 接口吗？鉴权是怎样的？

不是。本页的路径以及请求/响应示例都是对页面所述数据的示意性合成内容，不是官方公开的服务地址，也不是可用的凭证。示例展示的是会话 Cookie，或在 Authorisation 请求头中携带的 Bearer 令牌；会话启动时会返回 csrfToken，后续写入请求把它放在 X-CSRF-Token 中。所有设备、会话和令牌取值均为占位符，访问个人财务信息需要获得相应授权。

哪些字段描述 Cover 资格和进行中的工资预支？

资格部分包括 eligible、possible-loan-amounts、unlockable-amount、badge-unlockable-amount、classifier-suggested-amounts 以及决策原因。进行中预支的详情再加上 state、amount-formatted、repayment-date、days-till-due 和 disbursement-status。还款记录则单独给出 status、repayment_date、last_repayment_attempt_date 和 last_repayment_failure_reason。

哪些银行、交易、账单、收入与预算字段可用于现金流监控？

银行连接包含 provider-name、display-status 和 consent-expires-at，外加 account-balance 与 formatted-account-balance 合计；账户详情包含 account-name 和 formatted-balance。交易把 formatted-amount、full-description 与 merchant、transaction-category、corrected-made-on 配对，每日余额记录覆盖所选的 start_date 和 end_date。识别出的账单带有 display-amount、next-payment-expected 和 schedule，收入记录带有 formatted-amount、next-payment-expected 和 frequency。Smart Budget 定义 start-date 与 end-date、总额，以及通过 transaction-category-id 关联的 category-budgets，规划工具可据此把预期的资金流动与各类别支出上限做对比。

Equifax 信用分、Cleo Score 与返现余额有何区别？

信用分记录结合了 score、score-range-name、generated-at，以及 equifax_reason_code 与 cleo_recommendation 等 Equifax 因子详情。Cleo Score 则提供 score、max、status 以及覆盖各项财务习惯的 breakdown。返现现金钱包带有 currency、balance、formatted-balance、active 和 suspended，而奖励记录显示的是积分余额。

与 Cleo AI: Cash Advance & Money 相似的应用

Dave — Dave 的 ExtraCash 可垫付 25 至 500 美元，无信用审查、利息或滞纳金，关联银行账户后通常约五分钟内即可获批。
EarnIn — EarnIn 的 Cash Out 让美国打工者支取已挣到的工资，每天最高 200 美元、每个发薪周期最高 1,000 美元，无利息、无信用审查、也无强制费用。
Brigit — Brigit 的 Instant Cash 可垫付 25 至 500 美元，无信用审查、利息或滞纳金，并提供向 Experian、Equifax 和 TransUnion 报送的信用建设账户。
MoneyLion — MoneyLion 的 Instacash 最高可垫付 500 美元，无利息、无月费也无信用审查，并搭配 MoneyLion Spend 账户和 Credit Builder 信用建设贷款。
Albert — Albert 把预算和银行账户与 25 至 1,000 美元的 Instant Advance（视资格而定）以及应用内 AI 理财助手 Genius 放在一起。
Klover — Klover 关联银行账户后可垫付最高 750 美元，无信用审查、无利息也无滞纳金。
Tilt — Tilt 的 Cash Advance 可垫付 10 至 500 美元，无利息、无滞纳金也无信用审查，可选即时到账（可能收取手续费）。

需要集成这个 App 的数据 API？

我们可为任意指定 App 交付定制集成——源码交付 USD 500 起，或托管 API 按调用计费。告诉我们您需要的数据即可。

每个项目均签 NDA 与 SOW
3–7 天交付
验收通过后才付款
仅在授权范围内作业

获取报价

Cleo AI 数据 API：接口与字段

应用截图

API 端点一览

开启移动端会话

读取已登录用户资料

列出已关联银行登录与余额

分页读取已分类银行交易

读取每日滚动余额

获取 Cover 资格快照

读取当前 Cover / 工资预支状态

读取 Cover 还款状态

读取当前 Equifax 信用分

列出返现钱包

读取 Smart Budget 与分类上限

列出识别出的周期性账单

列出识别出的周期性收入

读取 Cleo Score 分项

读取返现奖励钱包余额

数据类别

数据使用场景与案例

Cover 授信结果回放

关联银行现金流监控

信用因子辅导信息流

账单与收入日历

常见问题

与 Cleo AI: Cash Advance & Money 相似的应用

更多信贷类应用

BAF Mobile - Cicilan Pinjaman

Bright: Loans & Credit Builder

Cairin: Pinjaman Daring Cepat

CASHe: Quick Personal Loan App

相关主题

需要集成这个 App 的数据 API？

Cleo AI 数据 API：接口与字段

应用截图

API 端点一览

开启移动端会话

读取已登录用户资料

列出已关联银行登录与余额

分页读取已分类银行交易

读取每日滚动余额

获取 Cover 资格快照

读取当前 Cover / 工资预支状态

读取 Cover 还款状态

读取当前 Equifax 信用分

列出返现钱包

读取 Smart Budget 与分类上限

列出识别出的周期性账单

列出识别出的周期性收入

读取 Cleo Score 分项

读取返现奖励钱包余额

数据类别

数据使用场景与案例

Cover 授信结果回放

关联银行现金流监控

信用因子辅导信息流

账单与收入日历

常见问题

相关应用

与 Cleo AI: Cash Advance & Money 相似的应用

更多信贷类应用

BAF Mobile - Cicilan Pinjaman

Bright: Loans & Credit Builder

Cairin: Pinjaman Daring Cepat

CASHe: Quick Personal Loan App

相关主题

需要集成这个 App 的数据 API？