Bulk Data Downloads (Premium)¶
Download historical data in CSV format.
Creating a Download¶
curl -X POST "https://api.airchain.ng/v1/exports" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"format": "csv",
"start_date": "2025-01-01",
"end_date": "2025-11-29",
"sensors": ["NGR-LOS-YAB-001", "NGR-LOS-YAB-002"],
"fields": ["timestamp", "pm25", "pm10", "aqi", "temperature", "humidity"]
}'
Response:
{
"export_id": "exp_abc123",
"status": "processing",
"estimated_completion": "2025-11-29T14:40:00Z"
}
Checking Status¶
curl "https://api.airchain.ng/v1/exports/exp_abc123" \
-H "Authorization: Bearer YOUR_API_KEY"
When ready:
{
"export_id": "exp_abc123",
"status": "completed",
"download_url": "https://exports.airchain.ng/exp_abc123.csv",
"expires_at": "2025-12-06T14:40:00Z",
"file_size": 15728640,
"row_count": 2880000
}
CSV Format¶
timestamp,sensor_id,pm25,pm10,aqi,temperature,humidity
2025-01-01T00:00:00Z,NGR-LOS-YAB-001,45.3,78.2,112,28.5,72
2025-01-01T00:05:00Z,NGR-LOS-YAB-001,46.1,79.8,114,28.6,71
...
Limits¶
- Max 1 year of data per export
- Max 10 concurrent exports
- Files expire after 7 days