Skip to content

Request Limits and Timeouts

Request Size Limits

Maximum request size: 10 MB

All endpoints support batch processing of multiple entities in a single request.

Use Case Recommended Entities per Request
Real-time analysis 1-10 entities
Portfolio analysis 50-100 entities
Bulk processing 100-250 entities

Example: Batch Request

# Python example
import requests

response = requests.post(
    'https://app.emmi.io/api/v1/emissions-estimates',
    headers={'X-API-Key': 'your-api-key'},
    json=batch_data,
    timeout=120
)

Timeouts

Request Size Recommended Timeout
Single entity 30 seconds
Small batch (1-10 entities) 60 seconds
Medium batch (10-50 entities) 90 seconds
Large batch (50-250 entities) 180 seconds
Very large batch (250+ entities) 300 seconds

Rate Limiting

Rate limits vary by subscription tier. Contact our team to discuss limits appropriate for your use case.