Bags DocsAPI Reference
BAGS Agent API — x402, payment links, products, and transactions.
Endpoint documentation for the BAGS Agent API at https://www.getbags.app. Prefer versioned paths under /api/v1/*.
OpenAPI source of truth: openapi.yaml.
Authentication
Authorization: Bearer bag_test_sk_your_key_here| Key type | Prefix | Environment |
|---|---|---|
| Test | bag_test_sk_* | Sandbox (no real money) |
| Live | bag_live_sk_* | Production |
See Authentication.
Endpoints
x402
Agent proxy, price card, receipts, discovery.
Payment Links
Agentic proxy links and targets.
Products
Per-call prices for your API.
Transactions
List and inspect payments.
System
Health, ready, version.
Rate Limits
Tiers and retry guidance.
Error Codes
Stable error codes and fixes.
Agent surfaces
| Surface | URL |
|---|---|
| MCP | POST /api/mcp/mcp |
| Auth skill | /auth.md |
| Merchants skill | /merchants.md |
See Agents & MCP and Sell to agents.