{"info":{"_postman_id":"ed8b51c8-cc05-4880-ae3c-27e8bae77b6a","name":"LiberiaGPS Developer API","description":" $\"\"$ \n\n

The LiberiaGPS (LibGPS) Developer API enables developers to integrate a Liberia digital addressing system into their applications, allowing users to retrieve accurate and standardized location details anywhere in Liberia.

LiberiaGPS is an open-source digital postal code system that assigns a unique, 6-character human-readable code to every 8m × 8m landspace within the borders of Liberia.

In many parts of Liberia, traditional addressing is inconsistent or unavailable. Locations are often described informally, for example:

\n
“Behind the big market near the junction”
\n

LiberiaGPS replaces this with a precise 6-digit digital postal code like below

MO-QL5-I40\n\n

Each code represents a specific physical location, making it easy to:

Share locations
\n
Power navigation
\n
Enable reliable deliveries
\n
Standardize addressing across applications
\n

🚀 What You Can Do With this API

With the LiberiaGPS API, you can:

Convert coordinates to LiberiaGPS code
\n
Convert LiberiaGPS code to coordinates (Latitute & Longitute)
\n
Retrieve detailed address information
\n
Search Places names accross Liberia (Beta Version)
\n
Power your delivery and navigation systems with Liberian Digital Addresses
\n

StartFragment

Base URL

https://api.libgps.com\n\n

EndFragment

🔐 Authentication

To access the API, you must include this GPS key in every request. This is a general GPS Key used by every user of this api for now.

Use this GPS Key

gpskey_3702f8fec83e73677a49ca31358208bd88890f49\n\n

Request Header

lib-gpskey: GPS_KEY\n\n

📦 Example Response

Below is a typical response returned by the API when querying a valid location:

{  \n\"success\": true,  \n\"message\": \"Address fetch success\",\n\"data\": { \n   \"liberia_gps_code\": \"MO-QL5-I40\",\n   \"county\": \"Montserrado\",\n   \"region\": \"Monrovia\",\n   \"community\": \"Monrovia\", \n   \"street_name\": \"Lynch Street\",\n   \"location\": {     \n         \"latitude\": 6.3096182,      \n         \"longitude\": -10.8051806    \n   },    \n  \"popular_nearby_place\": \"Antoinette Tubman Stadium\",\n  \"distance_from_nearby_place\": 46.47415055,\n  \"suggested_place_name\": \"None\", \n  \"description\": \"46m away from Antoinette Tubman Stadium\"  \n  }\n}\n\n

🧾 Response Field Breakdown

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Description
`liberia_gps_code`	Unique location code for the address
`county`	County where the location exists
`region`	Administrative region or city
`community`	Local community name
`street_name`	Street (if available)
`location`	Latitude and longitude coordinates
`popular_nearby_place`	Closest known landmark
`distance_from_nearby_place`	Distance (in meters) to landmark
`suggested_place_name`	Landmark name if very close
`description`	Human-readable location description

","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"36979713","collectionId":"ed8b51c8-cc05-4880-ae3c-27e8bae77b6a","publishedId":"2sBXikoBft","public":true,"customColor":{"top-bar":"f0faf2","right-sidebar":"303030","highlight":"073073"},"publishDate":"2026-04-02T05:13:57.000Z"},"item":[{"name":"Get Location by Lat,Long","id":"268ce261-e5a4-4174-9191-5bc8d2442489","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"lib-gpskey","value":"gpskey_3702f8...","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"lat\" : 6.295021,\r\n \"long\" : -10.677832\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.libgps.com/lookup/coords","description":"

📍 Lookup Address by Coordinates

This is a POST request that retrieve detailed address information in Liberia using geographic coordinates (latitude and longitude).

Endpoint

POST /api/lookup/coords\n\n

Base URL

https://api.libgps.com/\n\n

🔐 Headers

Content-Type: application/json\nlib-gpskey: YOUR_GPS_KEY\n\n

📥 Request Body

Must be a valid coordinate within the borders of Liberia.

{  \n   \"lat\": 6.3096182,\n   \"long\": -10.8051806\n}\n\n

Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`lat`	number	✅	Latitude of the location
`long`	number	✅	Longitude of the location

📤 Response

✅ Success Response

{\n    \"success\": true,\n    \"message\": \"Address fetch success\",\n    \"data\": {\n    \"liberia_gps_code\": \"MO-R1Q-82X\",\n     \"county\": \"Montserrado\",\n     \"region\": \"Greater Monrovia\",\n     \"community\": { \n        \"name\": \"MKK Community\", \n        \"type\": \"Local Area\" \n      },\n     \"street_name\": \"New Georgia Estate Road\",\n     \"location\": { \n         \"latitude\": 6.344368444158833, \n         \"longitude\": -10.757718086242678 \n      },\n     \"popular_nearby_place\": \"Safe Zone Community Cinic\",\n     \"distance_from_nearby_place\": 352.87364299,\n     \"suggested_place_name\": \"None\",\n     \"description\": \"4 minutes walk from  Safe Zone Community Cinic\"\n  }\n}\n\n

🧾 Response Fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Description
`liberia_gps_code`	Unique LiberiaGPS code for the location
`county`	County where the location is located
`region`	City or administrative region
`community`	Local community name
`street_name`	Street name (if available)
`location`	Exact latitude and longitude
`popular_nearby_place`	Closest known landmark
`distance_from_nearby_place`	Distance to landmark (in meters)
`suggested_place_name`	Landmark name if extremely close
`description`	Human-readable location description

❌ Error Responses

Missing Parameters

{  \n  \"success\": false,\n  \"message\": \"Latitude and Longitude are required!\"\n}\n\n

Liberia Bounds Only

{  \n   \"success\": false,\n   \"message\": \"Address coordinates are not in Liberia\"\n}\n\n

⚠️ Important Notes

Coordinates must fall within Liberia borders:
\n
- Latitude: 4.3 → 8.6
  \n
- Longitude: -11.5 → -7.3
  \n
\n
The response includes both:
\n
- Machine-readable data (coordinates, code)
  \n
- Human-friendly description (e.g., distance from landmark)
  \n
\n

💡 Example Use Cases For this EndPoint

Delivery apps - determine exact drop-off point
\n
E-commerce - ask users to enter the digital postal code and validate customer address
\n
Fintech - validate or convert coordinates into readable locations from users
\n

\n","urlObject":{"protocol":"https","path":["lookup","coords"],"host":["api","libgps","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"268ce261-e5a4-4174-9191-5bc8d2442489"},{"name":"Get Location by GPS Code","id":"d6157b02-b101-4045-98eb-e6b8fe7b5f61","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"lib-gpskey","value":"gpskey_3702f8fec83e73677a49ca31358208bd88890f49","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"lib_gps_code\" : \"MA-QE7-4JG\"\r\n}","options":{"raw":{"language":"json"}}},"url":"https://api.libgps.com/api/lookup/address","description":"

🔎 Lookup Address by LiberiaGPS Code

A Post request that Retrieve detailed address information in Liberia using a **LiberiaGPS Postal code '**MO-QKN-HS1'

Endpoint

POST /api/lookup/address\n\n

Base URL

https://api.libgps.com/\n\n

🔐 Headers

Content-Type: application/jsonlib-gps-key: YOUR_API_KEY\n\n

📥 Request Body

{  \n  \"lib_gps_code\": \"MO-QKN-HS1\"\n}\n\n

Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`lib_gps_code`	string	✅	LiberiaGPS code representing a location

📤 Response

✅ Success Response

{\n    \"success\": true,\n    \"message\": \"Address fetch success\",\n    \"data\": {\n    \"liberia_gps_code\": \"MO-R1Q-82X\",\n     \"county\": \"Montserrado\",\n     \"region\": \"Greater Monrovia\",\n     \"community\": { \n        \"name\": \"MKK Community\", \n        \"type\": \"Local Area\" \n      },\n     \"street_name\": \"New Georgia Estate Road\",\n     \"location\": { \n         \"latitude\": 6.344368444158833, \n         \"longitude\": -10.757718086242678 \n      },\n     \"popular_nearby_place\": \"Safe Zone Community Cinic\",\n     \"distance_from_nearby_place\": 352.87364299,\n     \"suggested_place_name\": \"None\",\n     \"description\": \"4 minutes walk from  Safe Zone Community Cinic\"\n  }\n}\n\n

🧾 Response Fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Description
`liberia_gps_code`	The provided LiberiaGPS code
`county`	County where the location exists
`region`	City or administrative region
`community`	Local community and Type
`street_name`	Street name (if available)
`location`	Decoded latitude and longitude
`popular_nearby_place`	Closest known landmark
`distance_from_nearby_place`	Distance to landmark (in meters)
`suggested_place_name`	Landmark name if extremely close
`description`	Human-readable location description

❌ Error Responses

Missing GPS Code

{  \n   \"success\": false,\n   \"message\": \"Liberian GPS code is required!\"\n}\n\n

Invalid Code Format

{  \n  \"success\": false,\n  \"message\": \"Invalid code format. Use XX-XXX-XXX\"\n}\n\n

Outside Liberia

{  \n   \"success\": false,\n   \"message\": \"GPS coordinates are outside of Liberia\"\n}\n\n

⚠️ Important Notes

Supported formats:
\n
- MO-QKN-HS1 ✅ (Always Recommended)
  \n
- QKNHS1 ⚠️ (limited support for now)
  \n
\n

💡 Example Use Cases For this EndPoint

Delivery apps - determine exact drop-off point
\n
E-commerce - ask users to enter the digital postal code and validate customer address
\n
Fintech - validate or convert coordinates into readable locations from users
\n

\n","urlObject":{"protocol":"https","path":["api","lookup","address"],"host":["api","libgps","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"d6157b02-b101-4045-98eb-e6b8fe7b5f61"},{"name":"Decode GPS Address","id":"8eeb6b39-6e2e-4705-a465-06c478095ce4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":false},"method":"POST","header":[{"key":"lib-gpskey","value":"gpskey_3702f8f...","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"lib_gps_code\" : \"MO-QKN-HS1\"\r\n}"},"url":"http://127.0.0.1:3001/api/gpscode/decode","description":"

🧭 Decode LiberiaGPS Digital Postal Code

A Post request that convert a LiberiaGPS postal-code into its corresponding geographic coordinates (latitude and longitude).

Endpoint

POST /api/lookup/gpscode/decode\n\n

Base URL

https://api.libgps.com\n\n

🔐 Headers

Content-Type: application/json\nlib-gpskey: YOUR_API_KEY\n\n

📥 Request Body

{  \n  \"lib_gps_code\": \"MO-QKN-HS1\"\n}\n\n

Parameters

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Type	Required	Description
`lib_gps_code`	string	✅	LiberiaGPS code to decode

📤 Response

✅ Success Response

{  \n   \"success\": true,\n   \"lat\": 6.309618,  \n   \"lng\": -10.805181\n}\n\n

🧾 Response Fields

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Field	Description
`lat`	Latitude of the decoded location
`lng`	Longitude of the decoded location

❌ Error Responses

Missing GPS Code

{  \n   \"success\": false,  \n   \"message\": \"Liberian GPS code is required!\"\n}\n\n

Invalid Code Format

{  \n  \"success\": false,  \n  \"message\": \"Invalid code entered. Use XX-XXX-XXX\"\n}\n\n

Invalid Characters

{  \n  \"success\": false,\n  \"message\": \"Invalid characters in GPS code\"\n}\n\n

Decoding Failure

{  \n  \"success\": false,\n  \"message\": \"Decoding failed: <error message>\"\n}\n\n

⚠️ Notes

This endpoint only returns coordinates
\n
It does not include address details to retrieve address details (use /lookup/address for that)
\n
Supports formats:
\n
- MO-QKN-HS1 ✅
  \n
- QKNHS1 ⚠️ (partial support)
  \n
\n
Coordinates are returned as the center of the 8m × 8m grid cell
\n

\n","urlObject":{"protocol":"http","port":"3001","path":["api","gpscode","decode"],"host":["127","0","0","1"],"query":[],"variable":[]}},"response":[],"_postman_id":"8eeb6b39-6e2e-4705-a465-06c478095ce4"},{"name":"Search Places","id":"46b0383e-f84a-4f22-a807-676668b806a2","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"lib-gpskey","value":"gpskey_3702f8fec83e73677a49ca31358208bd88890f49","type":"text"}],"url":"http://127.0.0.1:3001/api/lookup/place/search?name=A.M.%20Dogliotti%20College&lat=6.3&lng=-10.7","description":"

This Endpoint is usable but still in Beta version.

\n","urlObject":{"protocol":"http","port":"3001","path":["api","lookup","place","search"],"host":["127","0","0","1"],"query":[{"key":"name","value":"A.M.%20Dogliotti%20College"},{"key":"lat","value":"6.3"},{"key":"lng","value":"-10.7"}],"variable":[]}},"response":[],"_postman_id":"46b0383e-f84a-4f22-a807-676668b806a2"}]}