Build on Bangladesh's
verified retail network.

openapi: 3.0.3
info:
  title: outlets.bd API
  version: 0.1.0-preview
servers:
  - url: https://api.outlets.bd/v1
paths:
  /outlets:
    get:
      summary: List verified outlets
      parameters:
        - name: district
          in: query
          schema: { type: string }
        - name: status
          in: query
          schema: { type: string, enum: [pending, approved, rejected] }
      responses:
        '200':
          description: A page of outlets
  /outlets/{id}/verifications:
    post:
      summary: Submit a geo-stamped verification
      security:
        - bearerAuth: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [lat, lng]
              properties:
                lat: { type: number }
                lng: { type: number }
                accuracy_m: { type: number }
                photo_url: { type: string, format: uri }
                notes: { type: string }
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

POST https://your-app.example.com/webhooks/outlets
content-type: application/json
x-outlets-signature: t=1717000000,v1=...

{
  "event": "outlet.verified",
  "outlet": {
    "id": "8c1d...",
    "name": "Karim General Store",
    "district": "Dhaka",
    "lat": 23.8069,
    "lng": 90.3687,
    "verified_at": "2026-06-10T12:00:00Z"
  }
}