{
    "info": {
        "name": "FreightPulse API",
        "_postman_id": "freightpulse-v1",
        "description": "Logistics intelligence as structured JSON: EIA fuel prices, Warp FTL quotes, IMF PortWatch port activity, and FMCSA carriers. Base URL: https://freightpulsehq.com/api/v1",
        "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
    },
    "auth": {
        "type": "apikey",
        "apikey": [
            {
                "key": "key",
                "value": "X-API-Key",
                "type": "string"
            },
            {
                "key": "value",
                "value": "YOUR_API_KEY",
                "type": "string"
            },
            {
                "key": "in",
                "value": "header",
                "type": "string"
            }
        ]
    },
    "item": [
        {
            "name": "Market Data",
            "item": [
                {
                    "name": "GET /v1/fuel-prices",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://freightpulsehq.com/api/v1/fuel-prices",
                            "host": [
                                "freightpulsehq.com"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "fuel-prices"
                            ],
                            "query": []
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /v1/freight-rates",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://freightpulsehq.com/api/v1/freight-rates",
                            "host": [
                                "freightpulsehq.com"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "freight-rates"
                            ],
                            "query": [
                                {
                                    "key": "mode",
                                    "value": "trucking",
                                    "disabled": false,
                                    "description": "trucking (default) | ocean | air"
                                },
                                {
                                    "key": "origin_zip",
                                    "value": "10001",
                                    "disabled": false,
                                    "description": "US origin ZIP (required for trucking)"
                                },
                                {
                                    "key": "destination_zip",
                                    "value": "90210",
                                    "disabled": false,
                                    "description": "US destination ZIP (required for trucking)"
                                },
                                {
                                    "key": "pickup_date",
                                    "value": "",
                                    "disabled": true,
                                    "description": "YYYY-MM-DD (defaults to two weekdays from now)"
                                },
                                {
                                    "key": "origin_country",
                                    "value": "",
                                    "disabled": true,
                                    "description": "China | Vietnam | India | Taiwan | South Korea (required for ocean/air)"
                                },
                                {
                                    "key": "dest_zip",
                                    "value": "",
                                    "disabled": true,
                                    "description": "US destination ZIP (required for ocean/air)"
                                },
                                {
                                    "key": "origin_city",
                                    "value": "",
                                    "disabled": true,
                                    "description": "City in origin_country"
                                },
                                {
                                    "key": "qty",
                                    "value": "",
                                    "disabled": true,
                                    "description": "Quantity (default 1)"
                                },
                                {
                                    "key": "total_weight_lb",
                                    "value": "",
                                    "disabled": true,
                                    "description": "Total weight in pounds"
                                },
                                {
                                    "key": "container_size",
                                    "value": "",
                                    "disabled": true,
                                    "description": "Ocean only (default 40'DV)"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /v1/port-congestion",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://freightpulsehq.com/api/v1/port-congestion",
                            "host": [
                                "freightpulsehq.com"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "port-congestion"
                            ],
                            "query": [
                                {
                                    "key": "port",
                                    "value": "USLAX",
                                    "disabled": false,
                                    "description": "Port name or LOCODE"
                                },
                                {
                                    "key": "country",
                                    "value": "",
                                    "disabled": true,
                                    "description": "Country name or ISO3"
                                },
                                {
                                    "key": "region",
                                    "value": "",
                                    "disabled": true,
                                    "description": "Continent (e.g. Asia)"
                                },
                                {
                                    "key": "congestion",
                                    "value": "",
                                    "disabled": true,
                                    "description": "low | moderate | high"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /v1/disruptions",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://freightpulsehq.com/api/v1/disruptions",
                            "host": [
                                "freightpulsehq.com"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "disruptions"
                            ],
                            "query": [
                                {
                                    "key": "port",
                                    "value": "USLAX",
                                    "disabled": false,
                                    "description": "Port name or LOCODE - filters by distance"
                                },
                                {
                                    "key": "type",
                                    "value": "",
                                    "disabled": true,
                                    "description": "cyclone | earthquake | flood | volcano | drought | wildfire | severe_weather"
                                },
                                {
                                    "key": "severity",
                                    "value": "",
                                    "disabled": true,
                                    "description": "low | moderate | high"
                                },
                                {
                                    "key": "country",
                                    "value": "",
                                    "disabled": true,
                                    "description": "Country name or ISO3"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /v1/carriers",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://freightpulsehq.com/api/v1/carriers",
                            "host": [
                                "freightpulsehq.com"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "carriers"
                            ],
                            "query": [
                                {
                                    "key": "q",
                                    "value": "54283",
                                    "disabled": false,
                                    "description": "DOT number or carrier name (required for trucking)"
                                },
                                {
                                    "key": "type",
                                    "value": "trucking",
                                    "disabled": true,
                                    "description": "trucking (default) | ocean | air"
                                }
                            ]
                        }
                    },
                    "response": []
                }
            ]
        },
        {
            "name": "History & export",
            "item": [
                {
                    "name": "GET /v1/historical",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://freightpulsehq.com/api/v1/historical",
                            "host": [
                                "freightpulsehq.com"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "historical"
                            ],
                            "query": [
                                {
                                    "key": "metric",
                                    "value": "fuel_price_diesel_national",
                                    "disabled": false,
                                    "description": "fuel_price_diesel_national | fuel_price_gasoline_national"
                                },
                                {
                                    "key": "period",
                                    "value": "30d",
                                    "disabled": false,
                                    "description": "30d (default) | 90d | 1y"
                                }
                            ]
                        }
                    },
                    "response": []
                },
                {
                    "name": "GET /v1/export",
                    "request": {
                        "auth": {
                            "type": "inherit"
                        },
                        "method": "GET",
                        "header": [],
                        "url": {
                            "raw": "https://freightpulsehq.com/api/v1/export",
                            "host": [
                                "freightpulsehq.com"
                            ],
                            "path": [
                                "api",
                                "v1",
                                "export"
                            ],
                            "query": [
                                {
                                    "key": "type",
                                    "value": "fuel-prices",
                                    "disabled": false,
                                    "description": "Which dataset to export"
                                },
                                {
                                    "key": "format",
                                    "value": "json",
                                    "disabled": true,
                                    "description": "csv | json (default: json)"
                                }
                            ]
                        }
                    },
                    "response": []
                }
            ]
        }
    ],
    "variable": [
        {
            "key": "base_url",
            "value": "https://freightpulsehq.com/api/v1"
        },
        {
            "key": "api_key",
            "value": "YOUR_API_KEY"
        }
    ]
}