GROPEX Developer API
Integrate directory listings, verified credential checks, Live Places geospatial coordinates, and opportunity jobs directly into your mobile apps and fintech solutions.
Standard RFC-Compliant REST
All endpoints return predictable HTTP status codes, structured JSON payloads, and standard pagination metadata.
Geospatial Coordinates
Indexed WGS84 latitude/longitude coordinates and geodesic distance calculations within 25km radius for instant map rendering.
Zero-Trust Signed Webhooks
Cryptographically signed HMAC-SHA256 signatures for payment webhooks, ensuring zero-trust verification of financial transactions.
curl -X GET "https://gropex.goswiftarc.com/api/v1/listings?city=Lagos&verified_only=1" \
-H "Accept: application/json"API Endpoints Reference
Version 1.0 live public endpoints available for application developers.
/api/v1/health
Heartbeat endpoint returning current platform status and API release metadata.
{
"status": "operational",
"api_version": "v1.0.0",
"platform": "GROPEX Digital Ecosystem Ltd.",
"timestamp": "2026-10-30T00:00:00+00:00"
}/api/v1/categories
Retrieve all active categories, service types, and associated active listings counts.
{
"status": "success",
"count": 12,
"data": [
{
"id": 1,
"name": "Clean Energy & Solar Power",
"slug": "clean-energy-solar",
"type": "business",
"listings_count": 2,
"is_featured": true
}
]
}/api/v1/listings
Paginated discovery query supporting keyword search, type filtering, city filters, and verified badge filters.
q: Keyword query matched against title, tagline, description, and city.type: Filter bybusiness,professional,artisan, ororganisation.city: Filter by exact city (e.g.Victoria Island,Ikeja).verified_only: Set to1for verified profiles only.per_page: Number of records per page (max 50, default 15).
/api/v1/listings/{slug}
Full listing payload including verified coordinates, operating hours schedule, portfolio gallery URLs, and customer rating summaries.
/api/v1/places
Geospatial landmark hubs across Nigerian commercial centers (Lagos, Abuja, Port Harcourt, Kano, Ibadan) with precision coordinates for map clustering.
/api/v1/jobs
Public list of active opportunities, project tenders, contractor gig budgets, and submission deadlines.
Custom Integrations & Commercial Keys
Fintech partners, banks, and enterprise software providers requiring dedicated rate limits, OAuth/Sanctum bearer tokens, and custom webhook callbacks can request direct partner provisioning.
