# Hudhud B2B API

## Docs

- [Geocode Search](https://docs.hudhud.sa/api-reference/geocoding/geocode-search.md): Convert an address or place name into geographic coordinates. Returns matching locations with metadata such as coordinates, category, and bounding box.
- [Reverse Geocode](https://docs.hudhud.sa/api-reference/geocoding/reverse-geocode.md): Convert geographic coordinates into a human-readable address. Returns structured address components including city, road, suburb, and postal code.
- [Shortcode Lookup](https://docs.hudhud.sa/api-reference/geocoding/shortcode-lookup.md): Resolve a Saudi National Address shortcode (e.g. ABCD1234) into its full address and geographic coordinates. Returns both English and Arabic address representations.
- [Get Map Styles](https://docs.hudhud.sa/api-reference/maps/get-map-styles.md): Returns a MapLibre-compliant style JSON based on map_id, variant, and language.
- [List Place Categories](https://docs.hudhud.sa/api-reference/places/list-place-categories.md): Returns the supported place categories, each with an English and Arabic name. A category key may be used as the query of a places search to filter by that category.
- [Place Detail](https://docs.hudhud.sa/api-reference/places/place-detail.md): Fetch the full detail record for a single place by its ID, as returned by Places Search. Returns the richer attributes a search result omits: description, full address, contact details, social links, opening hours, amenities and media.
- [Places Search](https://docs.hudhud.sa/api-reference/places/places-search.md): Search the POI catalog by free text or by category around a user location, constrained to a bounding box. A query that exactly matches a category key (see GET /places/categories) filters by that category; any other query is a free-text search.
- [Distance Matrix](https://docs.hudhud.sa/api-reference/routing/distance-matrix.md): Compute a matrix of travel distances and durations between multiple origins and destinations. Returns pairwise distance and duration values for route planning and optimization.
- [Routing Directions](https://docs.hudhud.sa/api-reference/routing/routing-directions.md): Calculate turn-by-turn routing directions between two or more coordinates. Returns routes with optional step-by-step navigation instructions, voice guidance, and banner instructions.
- [Authentication](https://docs.hudhud.sa/guides/authentication.md): How to authenticate your requests to Hudhud Maps APIs.
- [Displaying a Map](https://docs.hudhud.sa/guides/displaying-a-map.md): Render vector maps using MapLibre-compliant styles and the KSA road network.
- [Response Format](https://docs.hudhud.sa/guides/response-format.md): Understanding the standard JSON envelope and error handling.
- [Introduction](https://docs.hudhud.sa/index.md): API documentation for the Hudhud Maps KSA road network and addressing services.
- [Quickstart](https://docs.hudhud.sa/quickstart.md): Make your first Hudhud API request in minutes.

## OpenAPI Specs

- [swagger](https://docs.hudhud.sa/swagger.json)

## Optional

- [Hudhud Website](https://hudhud.sa/)