Import Geo Location Routes from CSV

POST

https://platform-api.convirza.com/v3/geo-locations/{location_id}/routes/import

Geo Locations

Last modified:2026-07-24 13:10:44

Upload a CSV file to bulk import location routes.

CSV Format:

Standard accounts: Location, Address, City, State/Province, Zip/Postal Code, 10-Digit Phone, Claimed Zip (Optional)

Migrated accounts: Add Claimed States/Province (Optional) column after 10-Digit Phone

Features:

Automatic duplicate detection (based on location+address+city+state+zip)

Batch validation and geocoding

Row-level error reporting

Partial success support (successfully imports valid rows even if some fail)

NPA blacklist checking

4-digit zip code auto-padding

Returns:

Detailed results for each row (success/failure)

Total counts (successful/failed)

Error messages for failed rows

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Body Params multipart/form-dataRequired

Responses

🟢201

application/json

Bulk import completed (may include partial failures)

Bodyapplication/json

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://platform-api.convirza.com/v3/geo-locations/{location_id}/routes/import?is_migrated=' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""'

Response Example

201 - Example 1

{
    "total_rows": 10,
    "successful": 8,
    "failed": 2,
    "results": [
        {
            "row": 2,
            "success": true,
            "location_route_id": 101,
            "data": {
                "location": "Store 1",
                "address": "123 Main St",
                "city": "New York",
                "state": "NY",
                "zip": "10001",
                "phone": "2125551234"
            }
        },
        {
            "row": 3,
            "success": false,
            "error": "Zip:99999 not found",
            "data": {
                "location": "Store 2",
                "address": "456 Oak Ave",
                "city": "Boston",
                "state": "MA",
                "zip": "99999",
                "phone": "6175551234"
            }
        }
    ],
    "message": "Imported 8 routes, 2 failed"
}

Modified at 2026-07-24 13:10:44

Delete Geo Location Route

List Insights