The Midday API lets you access your financial data programmatically. Build custom integrations, automate workflows, or connect Midday to your own tools.
#Full API documentation
For complete API documentation including all endpoints, parameters, and examples:
#Overview
The API provides access to:
- Transactions
- Invoices
- Customers
- Time tracking projects and entries
- Financial reports
- Documents
- Bank accounts
#Authentication
The Midday API supports two authentication methods:
#API Keys (for your own data)
For accessing your own Midday data in scripts, automations, or personal tools.
- Go to Settings → Developer
- Click Create API key
- Give it a descriptive name
- Copy the key immediately (you won't see it again)
Include your API key in the Authorization header:
Authorization: Bearer your-api-key-here
#OAuth 2.0 (for user-facing apps)
For building apps that access other users' Midday data with their permission.
- Create an OAuth application in Settings → Developer
- Implement the OAuth authorization flow
- Exchange authorization codes for access tokens
- Use access tokens in API requests
#Base URL
All API endpoints use:
https://api.midday.ai/v1
#Rate limits
- Standard: 100 requests per minute
- Burst: Up to 200 requests in short bursts
If you exceed rate limits, you'll receive a 429 Too Many Requests response. Wait and retry with exponential backoff.
#SDKs
#NPM package
Install the Midday SDK:
npm install @midday-ai/sdk
#MCP package
For AI tool integrations:
npx @midday-ai/mcp
#Support
- Email: [email protected]