OneMap Singapore API
Browse all Onemap APIsOfficial vendor OpenAPI document · agent-readyMaps GeolocationGeocodingbearer11 EndpointsREST
For Agents
Search Singapore addresses, geocode and reverse-geocode coordinates, calculate routes, and pull government-themed map datasets via the official OneMap API.
Use for: Search for an address in Singapore by partial name, I want to reverse-geocode these WGS84 coordinates in Singapore, Convert these SVY21 coordinates to WGS84, Calculate a driving route between two Singapore locations
Not supported: Does not handle global geocoding, traffic-aware navigation, or non-Singapore datasets - use for Singapore address search, geocoding, routing, and government themes only.
OneMap is the authoritative national map of Singapore, providing geocoding, reverse geocoding, routing, coordinate system conversion, and access to government themed datasets. The API authenticates via a token endpoint and exposes address search across the Singapore land registry, reverse geocoding in both WGS84 and SVY21 coordinates, and bidirectional conversion between WGS84, SVY21, and EPSG:3857. Theme endpoints return categorised points of interest such as schools, parks, and transport facilities.
Install Jentic One Beta
Connect the OneMap Singapore API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the OneMap Singapore API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fonemap.gov.sg%2Fonemap-main" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fonemap.gov.sg%2Fonemap-main" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with OneMap Singapore API.
Search Singapore addresses and return coordinates with postal codes
Reverse-geocode coordinates in either WGS84 or SVY21 to nearby addresses
Convert coordinates between WGS84, SVY21, and EPSG:3857 projections
Calculate routes between two Singapore points using the routing service
List all government-published map themes available on OneMap
Retrieve points of interest within a theme such as schools or parks
Use Cases
Patterns agents use OneMap Singapore API for, with concrete tasks.
★ Singapore Address Autocomplete
Power Singapore-specific address search inside delivery, ride-hailing, or government service apps using the official OneMap address index. GET /api/common/elastic/search returns candidate addresses with WGS84 coordinates and postal codes that align with Singapore Land Authority records.
Search 'Marina Bay Sands' on /api/common/elastic/search and return the matching address with its postal code and coordinates.
Coordinate System Conversion for GIS Workflows
Translate field measurements between SVY21 (the Singapore national grid) and WGS84 or EPSG:3857 for web map display. The conversion endpoints under /api/common/convert handle each direction, removing the need for a local proj library when integrating with Singapore datasets.
Convert SVY21 coordinates 30000, 30000 to WGS84 using GET /api/common/convert/3414to4326.
Routing for Singapore Logistics
Plan vehicle, walking, or cycling routes within Singapore using the official routing service. GET /api/public/routingsvc/route accepts start and end coordinates plus a route type and returns a structured itinerary suited to Singapore's road and pedestrian network.
Calculate a driving route from 1.3521,103.8198 to 1.2936,103.8520 via /api/public/routingsvc/route and return the geometry and duration.
Agent Geocoding via Jentic
Logistics and civic agents resolve Singapore addresses or look up government themes through Jentic without managing the OneMap token directly. The agent searches for the geocoding intent, loads the schema, and executes the call with the access token Jentic injects from its vault.
Use Jentic search 'search singapore address' to locate /api/common/elastic/search, load its schema, and execute the lookup for a delivery address.
Key Endpoints
11 endpoints — onemap is the authoritative national map of singapore, providing geocoding, reverse geocoding, routing, coordinate system conversion, and access to government themed datasets.
METHOD
PATH
DESCRIPTION
POST
/api/auth/post/getToken
Get an authentication token
GET
/api/common/elastic/search
Search Singapore addresses
GET
/api/public/revgeocode
Reverse-geocode WGS84 coordinates
GET
/api/public/revgeocodexy
Reverse-geocode SVY21 coordinates
GET
/api/public/routingsvc/route
Calculate a route between two points
GET
/api/public/themesvc/getAllThemesInfo
List all available themes
GET
/api/public/themesvc/retrieveTheme
Retrieve theme data
POST
/api/auth/post/getToken
Get an authentication token
GET
/api/common/elastic/search
Search Singapore addresses
GET
/api/public/revgeocode
Reverse-geocode WGS84 coordinates
GET
/api/public/revgeocodexy
Reverse-geocode SVY21 coordinates
GET
/api/public/routingsvc/route
Calculate a route between two points
GET
/api/public/themesvc/getAllThemesInfo
List all available themes
GET
/api/public/themesvc/retrieveTheme
Retrieve theme data
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the OneMap Singapore API by hand means exchanging login credentials at /api/auth/post/getToken for a short-lived JWT, refreshing it, and building each search, geocode, and routing call against www.onemap.gov.sg yourself. Through Jentic you install once, import the OneMap Singapore API from the API Directory, store the login credentials once, and your agent calls it.
Permission scoping
OneMap passes its search, reverse-geocode, and routing parameters in the query string rather than the URL path, so you limit the agent to the operations it needs, such as address search or reverse geocoding. Theme retrieval or routing are excluded unless you add those operations to the allowed set.
Credential isolation
Your OneMap login credentials and JWT are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'reverse geocode singapore coordinates' or 'search a singapore address', and Jentic returns the matching OneMap operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
Alternative
OneMap Singapore (alternate)
An alternate OneMap spec entry covering the same Singapore endpoints.
Use when a different routing or theme entry point is preferred from the same provider.
Complementary
Stripe API
Pair OneMap address validation with Stripe to confirm Singapore billing addresses at checkout.
Use Stripe alongside OneMap when the product needs both address verification and payment processing in Singapore.
FAQs
Specific to using OneMap Singapore API through Jentic.
What authentication does the OneMap Singapore API use?
The API uses HTTP bearer tokens. Mint a token via POST /api/auth/post/getToken with email and password, then send it on subsequent calls. Jentic stores the credentials encrypted and exposes only a scoped reference to the agent.
Can I search Singapore addresses with the OneMap API?
Yes. GET /api/common/elastic/search returns matching addresses, postal codes, and coordinates from the Singapore Land Authority dataset, suitable for autocomplete and validation flows.
Does the OneMap API convert between SVY21 and WGS84?
Yes. The /api/common/convert endpoints provide bidirectional conversion between WGS84, SVY21, and EPSG:3857 so callers do not need a local projection library.
What route types are supported by OneMap routing?
GET /api/public/routingsvc/route accepts a route type parameter for driving, walking, cycling, and public transport options across Singapore's network. Inspect the OneMap docs for the current parameter list.
What are the rate limits for the OneMap Singapore API?
Rate limits are not declared in this OpenAPI spec. Consult onemap.gov.sg/docs for current public and authenticated tier limits before scaling traffic.
How do I geocode a Singapore address through Jentic?
Run pip install jentic, search 'search singapore address', then load the /api/common/elastic/search schema and execute. Jentic injects the bearer token from its vault and returns the JSON response for downstream use.
Can I limit what my agent is allowed to do with the OneMap Singapore API?
Yes. Because your Jentic One instance is self-hosted, your own rules decide which OneMap operations and credentials the agent may use. You can allow only the operations it needs, such as address search on /api/common/elastic/search or reverse geocoding on /api/public/revgeocode, and leave routing on /api/public/routingsvc/route or theme retrieval out of the allowed set. The token minted at /api/auth/post/getToken is injected at execution time, so the agent only ever calls the endpoints you approve.
GET STARTED