# Changelog

All notable changes to the Meow API will be documented in this file.

## 2025-12-02

### Added

- **Contacts API**: Full CRUD operations for managing payment contacts
  - `POST /contacts` - Create a new contact with ACH/wire/check or crypto address details
  - `GET /contacts` - List all contacts with optional nickname filtering
  - `GET /contacts/{contact_id}` - Get contact details
  - `PATCH /contacts/{contact_id}` - Update contact information and add payment details
  - `DELETE /contacts/{contact_id}` - Delete a contact
  - New API scopes: `contacts:read` and `contacts:write`
- **Billing API**: Complete invoice management system
  - **Products API**: Create and manage products with customizable pricing
    - `GET /billing/products` - List all products
    - `POST /billing/products` - Create a new product
    - `GET /billing/products/{product_id}` - Get product details
  - **Customers API**: Manage invoicing customers
    - `GET /billing/customers` - List all invoicing customers
    - `POST /billing/customers` - Create a new invoicing customer
    - `GET /billing/customers/{customer_id}` - Get customer details
  - **Invoices API**: Create and manage invoices
    - `GET /billing/invoices` - List all invoices
    - `POST /billing/invoices` - Create a new invoice with line items, discounts, and custom notes
    - `GET /billing/invoices/{invoice_id}` - Get invoice details
    - `GET /billing/invoices/{invoice_id}/pdf` - Download invoice as PDF
  - **Line Items API**: Access invoice line item details
    - `GET /billing/invoices/{invoice_id}/line-items` - List invoice line items
    - `GET /billing/invoices/{invoice_id}/line-items/{line_item_id}` - Get line item details
  - **Payment Configuration API**: Configure payment methods and collection accounts
    - `GET /billing/payment-method-types` - Get available payment method types
    - `GET /billing/accounts` - List collection accounts for receiving payments
  - New API scopes for billing operations:
    - `billing:products:read` and `billing:products:write`
    - `billing:customers:read` and `billing:customers:write`
    - `billing:invoices:read` and `billing:invoices:write`
    - `billing:accounts:read`
  - Recurring invoice support with RFC 2445 RRULE scheduling
  - Invoice email notifications with custom recipient lists
- **Transfer APIs**: Comprehensive transfer capabilities
  - `POST /accounts/{account_id}/book` - Create internal book transfers between accounts
  - `POST /accounts/{account_id}/ach` - Create ACH transfers to external counterparties
  - `POST /accounts/{account_id}/wire` - Create wire transfers to external counterparties
  - `GET /accounts/{account_id}/wires/{wire_transfer_id}` - Get wire transfer details
  - New API scopes: `transfers:book:write`, `transfers:ach:write`, `transfers:wire:write`
- **Payment Networks API**:
  - `GET /accounts/{account_id}/payment-networks` - List payment networks supported by an account
  - New API scope: `accounts:payment-networks`
- **Routing Number Validation**:
  - `GET /routing-numbers/{routing_number}` - Validate routing numbers and get bank information including name, address, and supported payment methods (ACH/Wire)
- **API Keys Management**:
  - `GET /api-keys/accessible-entities` - List all entities accessible by the current API key
  - `GET /api-keys/current` - Get metadata about the current API key
- **Multi-entity Support**:
  - Optional `x-entity-id` header to scope API requests to specific entities
  - Use `/api-keys/accessible-entities` to discover available entities
- **Payment Method Support**:
  - Bank transfers (ACH/Wire)
  - Credit/debit cards
  - ACH direct debit
  - International wires
  - USDC payments (Ethereum, Solana, Base) - requires Bridge feature flag


## 2025-04-08

### Added

- Combined Read and Write APIs into a single unified Meow API
- **Accounts API**: Comprehensive financial data access
  - `GET /accounts` - List bank accounts
  - `GET /accounts/{account_id}` - Get account details
  - `GET /accounts/{account_id}/transactions` - List transactions with time filtering and pagination
  - `GET /accounts/{account_id}/balances` - List account balances with time filtering
  - New API scopes: `accounts:read`, `accounts:transactions`, `accounts:balances`
- **USDC Transaction Support**:
  - `POST /accounts/{account_id}/usdc` - Create USDC transactions
  - `GET /accounts/{account_id}/transactions/{transaction_id}` - Get USDC transaction details
  - New API scope: `transfers:usdc:write`
  - Support for multiple blockchain networks:
    - Ethereum
    - Solana
    - Base
- **Health Check**:
  - `GET /health` - API service health status endpoint
- **Authentication & Security**:
  - API key authentication via `x-api-key` header
  - Standardized error handling with detailed validation responses
  - Scoped API permissions for granular access control