# Balad API Platform

> English, human-maintained documentation for agents, with Persian UI terms in parentheses. The public website uses Persian. API coordinates are normally `longitude,latitude`.

Start with [Platform overview](/dashboard/docs/llms/overview.md). Use only services and actions the user has requested. Never expose keys, session tokens, phone numbers or one-time codes in logs or public output.

## Account and dashboard

- [Phone login and session](/dashboard/docs/llms/login.md): Ask for the user's phone number and complete SMS verification.
- [Organizations and API keys](/dashboard/docs/llms/organizations-and-keys.md): Select an organization and create keys for browser or server use.
- [Usage, pricing and free quota](/dashboard/docs/llms/usage-and-pricing.md): View usage, monthly free requests and current prices.

## Build with the APIs

- [Vector and raster maps](/dashboard/docs/llms/maps.md): Display an interactive map, choose a key, add a marker and keep attribution visible.
- [Static map images](/dashboard/docs/llms/static-images.md): Request a JPEG by center or bounding box and understand image size and zoom.
- [Place search](/dashboard/docs/llms/search.md): Find places by text and understand user location versus map center.
- [Address to point](/dashboard/docs/llms/geocoding.md): Turn an address into coordinates (تبدیل آدرس به نقطه).
- [Point to address](/dashboard/docs/llms/reverse-geocoding.md): Turn coordinates into a readable address (تبدیل نقطه به آدرس).
- [Errors and troubleshooting](/dashboard/docs/llms/errors.md): Diagnose authentication, access and upstream errors.

## Examples

- [WordPress map](/dashboard/docs/llms/wordpress.md): Add a map and marker to a Custom HTML block.
- [Practical examples](/dashboard/docs/llms/examples.md): Place cards, branch maps and address selection.