---
title: "Preview claimable transactions for a (merchant, period) window. Uses the same eligibility predicate as create; surfaces conflicts when other invoices already own rows in the window. Used by the Create-invoice form to validate the window before submit."
method: GET
path: "/api/v1/admin/invoices/claimable"
tags: ["Invoice", "Admin"]
---

# Preview claimable transactions for a (merchant, period) window. Uses the same eligibility predicate as create; surfaces conflicts when other invoices already own rows in the window. Used by the Create-invoice form to validate the window before submit.

`GET /api/v1/admin/invoices/claimable`

Preview claimable transactions for a (merchant, period) window. Uses the same eligibility predicate as create; surfaces conflicts when other invoices already own rows in the window. Used by the Create-invoice form to validate the window before submit.

## Query parameters

- `merchant_id` string, uuid, required
- `period_start` string, date, required — UTC date, inclusive
- `period_end` string, date, required — UTC date, exclusive

## Response `200`

Success

- InvoiceClaimablePreviewResponse
  - `success` boolean, required — Indicates if the request was successful
  - `data` object, required
    - `transaction_count` number, required — Total eligible transactions in the window (not capped by the sample list)
    - `fee_totals_by_currency` object[], required
      - `currency` string, required — Fee currency
      - `total_minor` number, required
      - `transaction_count` number, required
    - `transactions` object[], required — Sample of up to 500 eligible transactions; truncated=true when more exist
      - `transaction_id` string, uuid, required
      - `transaction_number` string, required
      - `created_at` string, date-time, required
      - `deposit_amount_minor` number, required
      - `deposit_currency` string, required — Currency of the deposit
      - `fee_total_minor` number, required — Sum of positive fees on this transaction, in fee_currency
      - `fee_currency` string, nullable, required — Currency of the fee total
    - `truncated` boolean, required
    - `conflicts` object[], required — Invoices that already own transactions in this window
      - `invoice_id` string, uuid, required
      - `invoice_number` string, required
      - `status` union, required — Lifecycle status of the invoice
        - 'draft'
        - 'issued'
        - 'paid'
        - 'void'
      - `transaction_count` number, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/banqzinc/apis/quidkey-api.md) · [All operations](https://skmtc.net/banqzinc/apis/quidkey-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/banqzinc/quidkey-api/versions/f86d2bdbcb08/schema)