# Ask Penny (POST /assistant)

Source: DepositScout Data API docs — https://depositscout.com/developers/docs/assistant

DepositScout's savings assistant. Coming soon.

---

- **Cost:** 10 DS Credits per request
- **Scope:** `assistant`
- **Same data as:** `/api/savings-assistant` on the DepositScout website

This endpoint is in the catalogue so you can plan for it, but it isn't live yet. Calling it returns `404 not_found`. Watch the [changelog](https://depositscout.com/developers/changelog).

## Request

POST https://depositscout.com/api/developer/v1/assistant

No parameters.

## Example

**curl**

```bash
curl -X POST "https://depositscout.com/api/developer/v1/assistant" \
  -H "Authorization: Bearer $DS_API_KEY"
```

**Node**

```javascript
const res = await fetch("https://depositscout.com/api/developer/v1/assistant", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.DS_API_KEY}` },
});
const { data, meta } = await res.json();
console.log(meta.creditsCharged, data);
```

**Python**

```python
import os, requests

res = requests.post(
    "https://depositscout.com/api/developer/v1/assistant",
    headers={"Authorization": f"Bearer {os.environ['DS_API_KEY']}"},
)
body = res.json()
print(body["meta"]["creditsCharged"], body["data"])
```

## Response

`data` is a single object. Every 2xx also sets `X-DS-Request-Id`, `X-DS-Credits-Charged`, `X-DS-Credits-Balance`, the `X-RateLimit-*` trio and an `ETag`.

```json
{
  "data": {
    "…": "the item"
  },
  "meta": {
    "requestId": "req_7f3a9c2d1b4e5a6f7c8d",
    "generatedAt": "2026-09-21T09:00:00.000Z",
    "creditsCharged": 10,
    "creditsBalance": 199,
    "attribution": "Rates powered by DepositScout — depositscout.com"
  }
}
```

Errors follow the [shared error contract](https://depositscout.com/developers/docs#errors). Back to [all endpoints](https://depositscout.com/developers/docs#endpoints).