# BanQu

> BanQu is a supply-chain traceability and sustainability platform that records assets, transfers,
> transactions and supplier form data on a blockchain-backed (non-crypto) distributed ledger, giving
> brands farm-to-shelf visibility across agriculture, recycling, apparel, beauty and mining supply
> chains. Its production REST API (OpenAPI 3.0.3, 134 paths / 191 operations) is served live at
> https://banqu.app/api/v1/schema and rendered at https://api.banqu.app/openapi. Authentication is a
> JWT bearer token; persistent API tokens are minted from /auth/api-tokens after selecting which
> account to act as. This file was generated by API Evangelist from BanQu's public surface —
> BanQu does not publish an llms.txt of its own (https://www.banqu.co/llms.txt → 404).

## API

- [BanQu API reference (Swagger UI)](https://api.banqu.app/openapi): Rendered reference for the whole API.
- [BanQu OpenAPI 3.0.3 document](https://banqu.app/api/v1/schema): The live machine-readable contract, version 3.3.4.
- Base URL: `https://banqu.app/api/v1`
- Auth: `Authorization: Bearer <jwt>` (the spec also documents an `X-BQ-Token` header — see the authentication artifact).

## Capability groups

- **Authentication** — list accounts, mint per-account session tokens, create/list/revoke persistent API tokens, invite-token signup.
- **User Profile / Profile Sharing** — profile record, sections, photo, password, and packaged profile shares.
- **Public Profiles** — read supplier profiles, assets, connections, geo-data and transactions shared to you.
- **Organizations / Associates / Roles / Features** — org accounts, sub-orgs, associates, CRUD-per-capability roles, licensing, private labeling.
- **Connections** — connected identities and organizations, invitations, dependents, destinations, roles, CSV export, structured filter.
- **Assets / Asset Categories** — tracked commodity and product units with codes, units of measure and prices.
- **Asset Transfers / Transfer Claiming / Transformations** — movement of asset quantity between accounts, claim tokens for last-mile agents, and consumption of inputs into new outputs.
- **Asset Transactions** — buy, sell, transfer, deposit and transformation events, individually or in batch, with finalize and history.
- **Asset Sharing** — scoped shares of assets and their transfers to another party.
- **Payment Adjustments** — currency or percentage adjustments on the payment leg of a trade.
- **Forms / Form Data Entries** — questionnaire definitions and submitted entries with approve / deny / review / reject / withdraw and assignable responders.
- **Attachments** — pre-signed upload URLs.
- **Smart Contracts / Data Processors / Validation Workflows** — automation that reacts to system events, imports custom CSV/XLSX formats, and validates writes.
- **Notifications / Tutorials** — polled notification feed and interactive guides.

## Key conventions

- Pagination is `offset` + `limit` (default limit 20); sorting is `sortBy=field:asc,field:desc`; free-text search is `search`.
- Timestamps are numeric epoch milliseconds, not RFC 3339 strings.
- Most first-class resources support soft delete: `DELETE` then `POST .../restore`.
- `preventNotify=true` suppresses notification side effects on writes — use it for bulk import.
- Chain of custody: `GET /assets/{assetId}/sources` and `GET /transfers/{transferId}/sources`.
- There is **no** idempotency-key mechanism, **no** documented rate limit, and **no** operationId on any operation.

## API Evangelist artifacts

- [OpenAPI (verbatim)](openapi/banqu-openapi-original.json)
- [Authentication profile](authentication/banqu-authentication.yml)
- [API conventions](conventions/banqu-conventions.yml)
- [Error catalog](errors/banqu-problem-types.yml)
- [Data model](data-model/banqu-data-model.yml)
- [Lifecycle](lifecycle/banqu-lifecycle.yml)
- [Conformance](conformance/banqu-conformance.yml)
- [Event / webhook surface](asyncapi/banqu-webhooks.yml)
- [Candidate MCP tool shape (not a BanQu server)](mcp/banqu-mcp.yml)
- [Domain security probe](security/banqu-domain-security.yml)
- [Agent skills](skills/_index.yml)

## Company

- [BanQu](https://www.banqu.co/): Sustainable visibility software for supply chain sourcing.
- [Platform](https://www.banqu.co/platform): Distributed-ledger platform, "Open API and CSV up- and download options", integrates with SAP, Oracle and similar legacy systems.
- [Blog](https://www.banqu.co/blog) · [News](https://www.banqu.co/news) · [Case studies](https://www.banqu.co/case-studies)
- [Support policy](https://www.banqu.co/support-policy) · [Privacy policy](https://www.banqu.co/privacy-policy)
- [Application login](https://banqu.app/)
- Contact: info@banqu.co · +1 (833) 600-0010

## Not available

- No developer portal, no getting-started guide, no changelog, no status page, no pricing page.
- No SDKs in any public package registry and no BanQu GitHub organization.
- No MCP server, no A2A agent card, no AsyncAPI, no `/.well-known/` documents (all probes 404).