Forward Geocoding API

1. The Geocode.Farm Forward Geocoding API provides latitude and longitude coordinates for a given address.
2. API authentication is required via an API key.

1. GET https://api.geocode.farm/forward/

1. API keys are required for all requests.
2. Provide the key using the key parameter in the URL.

GET https://api.geocode.farm/forward/?key=YOUR-API-KEY-HERE&addr=30+N+Gould+St,+Ste+R,+Sheridan,+WY+82801+USA

{
    "LEGAL": {
        "notice": "This system is the property of Geocode.Farm and any information contained herein is Copyright (c) Geocode.Farm. Usage is subject to the Terms of Service.",
        "terms": "https:\/\/geocode.farm\/policies\/terms-of-service\/",
        "privacy": "https:\/\/geocode.farm\/policies\/privacy-policy\/"
    },
    "STATUS": {
        "key": "VALID",
        "request": "VALID",
        "status": "SUCCESS",
        "credit_used": "1"
    },
    "USER": {
        "key": "YOUR-API-KEY-HERE",
        "name": "Your Name",
        "email": "yourname@yourdomain.com",
        "usage_limit": "UNLIMITED",
        "used_today": "1",
        "remaining_limit": "UNLIMITED"
    },
    "RESULTS": {
        "request": {
            "addr": "30 N Gould St, Ste R, Sheridan, WY 82801 USA"
        },
        "result": {
            "coordinates": {
                "lat": "44.7977733966548",
                "lon": "-106.954917523499"
            },
            "address": {
                "full_address": "30 N Gould St, Sheridan, WY 82801, United States",
                "house_number": "30",
                "street_name": "N Gould St",
                "locality": "Sheridan",
                "admin_2": "Sheridan County",
                "admin_1": "WY",
                "country": "United States",
                "postal_code": "82801"
            },
            "accuracy": "EXACT_MATCH"
        }
    }
}

STATUS

• key: Indicates API key validity ("VALID" or "INVALID").
• status: Request status ("SUCCESS" or "FAILED").
• request: Whether the request was valid ("VALID" or "INVALID").
• credit_used: Number of API credits or plan queries consumed. Will be 0 on failed, as failed requests DO NOT use credit.

USER

• key: API key used in the request.
• name: Registered name.
• email: Rgistered email.
• usage_limit: Daily API query limit (e.g., "UNLIMITED" or a set number).
• used_today: Number of requests made today.
• remaining_limit: Remaining query limit for today.

RESULTS

• request: The originally requested address.
• result: Contains geolocation details:
  • coordinates: Latitude and longitude.
  • address: Full structured address data.
  • accuracy: Quality of match (e.g. "EXACT_MATCH", "HIGH_ACCURACY", "MEDIUM_ACCURACY", "LOW_ACCURACY", or "UNKNOWN_ACCURACY").

The following are provided with each result as HTTP Status Codes:

• 200 - Results Returned Successfully.
• 400 - Address parameter missing or invalid.
• 401 - API key is invalid or missing.
• 402 - No credit available or expired API key.
• 404 - No matching results found.
• 429 - Rate limit exceeded.
• 500 - An unexpected error occurred. In this case, contact support immediately to report the issue.