File size: 2,061 Bytes
c09f67c | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 | ---
title: API Reference
description: Access your Midday data programmatically through the REST API.
section: developer
order: 1
---
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:
**[api.midday.ai](https://api.midday.ai)**
## 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.
1. Go to [Settings → Developer](https://app.midday.ai/settings/developer)
2. Click **Create API key**
3. Give it a descriptive name
4. 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.
1. Create an OAuth application in [Settings → Developer](https://app.midday.ai/settings/developer)
2. Implement the OAuth authorization flow
3. Exchange authorization codes for access tokens
4. Use access tokens in API requests
[Build an OAuth app →](/docs/build-oauth-app)
## 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:
```bash
npm install @midday-ai/sdk
```
### MCP package
For AI tool integrations:
```bash
npx @midday-ai/mcp
```
[MCP documentation →](/docs/assistant-mcp)
## Support
- **Email**: [support@midday.ai](mailto:support@midday.ai)
|