---
title: Investigate a transaction
description: Gather full context before proposing changes.
canonical: https://bennybooks.com/developers/guides/investigate
markdown: https://bennybooks.com/developers/guides/investigate.md
---
# Investigate a transaction

Gather full context before proposing changes.

> **Documentation index.** Fetch [https://bennybooks.com/developers/llms.txt](https://bennybooks.com/developers/llms.txt) before browsing further. Prefer markdown (this file or `Accept: text/markdown`). Site-wide map: [https://bennybooks.com/llms.txt](https://bennybooks.com/llms.txt).

Use get_transaction to load the transaction row plus all linked notes and receipts in a single call. Prefer that over list_notes to save tool round-trips and tokens.

### `GET https://bennybooks.com/api/v1/transactions/{id}`

Full transaction with linked notes and receipts. Prefer this over list_notes for investigation.

- operationId: `get_transaction`
- scope: `read`

**Parameters**

- `id` (uuid, required) — Transaction ID

**Response**

```json
{
  "data": {
    "transaction": { … },
    "notes": [ { "id": "…", "content": "…", "createdAt": "…" } ],
    "receipts": [ { "id": "…", "fileName": "invoice.pdf", … } ]
  }
}
```

## Related reads

### `GET https://bennybooks.com/api/v1/receipts/search`

Search receipts by file name or OCR text. Returns up to 50 results.

- operationId: `search_receipts`
- scope: `read`

**Parameters**

- `q` (string, required) — Search query

**Response**

```json
{ "data": [ … ], "meta": { "count": 3, "limit": 50 } }
```

Search receipts when you have a vendor name or amount but no linked document yet. list_notes remains available but is redundant with get_transaction for most agents.

---

## Machine-readable

- HTML: https://bennybooks.com/developers/guides/investigate
- Markdown: https://bennybooks.com/developers/guides/investigate.md
- Docs index: https://bennybooks.com/developers/llms.txt
- OpenAPI: https://bennybooks.com/openapi.json
- Skill: https://bennybooks.com/skill.md
- Auth: https://bennybooks.com/auth.md

```json
{
  "@context": "https://schema.org",
  "@type": "TechArticle",
  "headline": "Investigate a transaction",
  "description": "Gather full context before proposing changes.",
  "url": "https://bennybooks.com/developers/guides/investigate",
  "inLanguage": "en",
  "encodingFormat": [
    "text/html",
    "text/markdown"
  ],
  "isAccessibleForFree": true,
  "publisher": {
    "@type": "Organization",
    "name": "BennyBooks",
    "url": "https://bennybooks.com",
    "logo": {
      "@type": "ImageObject",
      "url": "https://bennybooks.com/apple-icon.png"
    }
  },
  "mainEntityOfPage": "https://bennybooks.com/developers/guides/investigate",
  "image": "https://bennybooks.com/opengraph-image",
  "workExample": {
    "@type": "CreativeWork",
    "url": "https://bennybooks.com/developers/guides/investigate.md",
    "encodingFormat": "text/markdown",
    "name": "Investigate a transaction (Markdown)"
  },
  "about": {
    "@type": "WebAPI",
    "name": "BennyBooks Agent API",
    "url": "https://bennybooks.com/api/v1",
    "documentation": "https://bennybooks.com/developers"
  }
}
```
