FedEx APIfedex.com ↗

"""
FedEx Web API Scraper - Usage Example

Get your API key from: https://parse.bot/settings
"""
import requests
import os


class ParseClient:
    """Client for FedEx Web API Scraper."""

    def __init__(self, api_key=None):
        self.api_key = api_key or os.getenv("PARSE_API_KEY")
        self.base_url = "https://api.parse.bot"
        self.scraper_id = "9ed4e97f-a431-48ab-93c9-b3fb85713a29"

    def _call(self, endpoint, method="POST", **params):
        """Make API call."""
        url = f"{self.base_url}/scraper/{self.scraper_id}/{endpoint}"
        headers = {
            "X-API-Key": self.api_key,
            "Content-Type": "application/json",
        }
        payload = dict(params)
        if method.upper() == "GET":
            response = requests.get(url, headers=headers, params=payload)
        else:
            response = requests.post(url, headers=headers, json=payload)
        response.raise_for_status()
        data = response.json()
        return data

    def track_by_tracking_number(self, tracking_number):
        """Track a FedEx shipment by tracking number. Returns detailed package status including current location, estimated delivery, scan event history, and delivery status flags. The API always returns a response for any tracking number format; invalid or expired numbers return with a notFound flag and error in the errorList. Paginates implicitly (single request returns all events for one tracking number)."""
        return self._call("track_by_tracking_number", method="GET", tracking_number=tracking_number)

    def validate_address(self, postal_code, country_code=None):
        """Validate a postal code and country combination."""
        return self._call("validate_address", method="GET", postal_code=postal_code, country_code=country_code)

    def get_countries(self):
        """Get a list of all countries and territories supported by FedEx with their codes, region, currency, and shipping capabilities including domestic shipping and postal awareness. Returns over 200 countries. No input required."""
        return self._call("get_countries", method="GET")

    def find_locations(self, postal_code, country_code=None):
        """Search for FedEx locations near a specific postal code."""
        return self._call("find_locations", method="GET", postal_code=postal_code, country_code=country_code)

    def get_country_details(self, country_code):
        """Get detailed shipping information for a specific country including states/provinces, allowed ship dates, customs value limits, credit card options, postal awareness by carrier, and system of measure. Useful for determining shipping capabilities and constraints for a given destination country."""
        return self._call("get_country_details", method="GET", country_code=country_code)


if __name__ == "__main__":
    client = ParseClient()

    result = client.track_by_tracking_number(tracking_number="<FedEx tracking number (typical>")
    print("track_by_tracking_number:", result)

    result = client.validate_address(postal_code="<Postal or ZIP code>", country_code="<ISO country code (e.g., US, CA>")
    print("validate_address:", result)

    result = client.get_countries()
    print("get_countries:", result)

    result = client.find_locations(postal_code="<Postal or ZIP code>", country_code="<ISO country code>")
    print("find_locations:", result)

    result = client.get_country_details(country_code="<ISO 2-letter country code (e.g>")
    print("get_country_details:", result)