List Geo Locations

GET

https://platform-api.convirza.com/v3/geo-locations

Geo Locations

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

Returns a paginated list of active geo locations for a given org unit.

Each row includes a location_count — the number of active routes belonging to that geo location.

Filtering / Sorting

searchKeyword performs a case-insensitive ILIKE match on location_name

sort_by accepts: location_name, location_created, location_modified, location_count

sort_order accepts: asc (default), desc

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200

application/json

Paginated list of geo locations

Bodyapplication/json

🟠401

🟠403

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://platform-api.convirza.com/v3/geo-locations?sort_by=&sort_order=&searchKeyword=&limit=&page=&org_unit_id=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "data": [
        {
            "location_id": 1,
            "location_name": "New York Office",
            "location_created": "2024-01-15T10:00:00Z",
            "location_modified": "2024-06-01T09:30:00Z",
            "location_count": "3"
        }
    ],
    "total": 1
}

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

Create DNI Setting

Create Geo Location