---
title: "Add or update new locations to Geolocations list in batches"
method: POST
path: "/misc/geo/batchlocations"
tags: ["misc"]
---

# Add or update new locations to Geolocations list in batches

`POST /misc/geo/batchlocations`

Adds or updates new locations to a Geolocations list with reference to location id in batches. Batches are limited to 100 locations.

## Request body

- PostRouteLocation[]
  - `location_route_id` integer — Location id of an existing location to update. Type: integer.
  - `location_id` integer, required — GeoRoute list id. Type: integer.
  - `route_location` string, required — Location name. Type: string.
  - `route_address` string, required — Location address. Type: string.
  - `route_city` string, required — Location city name. Type: string.
  - `route_state` string, required — Location state name. Type: string.
  - `route_zip` string, required — Location Zip code. Type: string.
  - `route_target` string, required — Location phone number. Type: string.
  - `claimed_states` string — Location claimed state. Type: string.
  - `claimed_zip` string — Location claimed zip. Type: string.
  - `hunt_type` 'roundrobin' | 'overflow' | 'simultaneous' | 'rollover' — hunt_type. Type: enum (string); Allowed values: roundrobin, overflow, simultaneous, rollover.
  - `overflowNumbers` OverflowNumbers[] — overflowNumbers. Type: array of object (overflowNumbers).
    - `overflowNumber` integer, required — The unique identifier for the overflowNumber. Type: integer (int32).
    - `rings` integer, required — The unique identifier for the rings for overflowNumber. Type: integer (int32).

## Response `200`

The result of the submission and outcome for the newly added or updated location

- PostBatchLocationResponse
  - `result` string, required — Outcome of the request. String, typically 'success' or 'error'.
  - `err` string, required — Error message when result='error'. String. Empty/null on success.
  - `data` object — Response payload. Shape varies by endpoint.
    - `success` integer — count of successful locations created/updated. Type: integer.
    - `errors` integer — count of unsuccessful locations created/updated. Type: integer.
    - `errorMessage` string[] — number indicating array item with error and error message. Type: array of string.

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/convirza/apis/convirza-apis.md) · [All operations](https://skmtc.net/convirza/apis/convirza-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convirza/convirza-apis/versions/ccf9bbe34f5a/schema)