Mushak BD REST API

Create a Mushak-6.3 challan from JSON.

curl -X POST https://mushak.globyn.com/api/public/v1/documents \
  -H "Authorization: Bearer mbk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "invoice_no": "INV-1042",
    "invoice_date": "2026-05-19",
    "buyer_name": "Acme Ltd",
    "buyer_bin": "001234567-0202",
    "buyer_address": "Dhaka",
    "items": [
      {"description": "Web hosting (1 year)", "quantity": 1, "unit_price": 12000, "vat_rate": 15}
    ]
  }'

Response 201

{
  "id": "uuid",
  "serial": "MUSHAK-6.3/2026/000042",
  "qr_token": "abc123...",
  "verify_url": "https://mushak.globyn.com/verify/abc123...",
  "created_at": "2026-05-19T10:00:00Z"
}

Optional: brand_id (defaults to your default brand).

Create up to 100 Mushak-6.3 challans in a single call. Each document consumes 1 credit.

curl -X POST https://mushak.globyn.com/api/public/v1/documents/bulk \
  -H "Authorization: Bearer mbk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "documents": [
      {
        "invoice_no": "INV-1001",
        "invoice_date": "2026-05-19",
        "buyer_name": "Acme Ltd",
        "items": [{"description": "Service A", "quantity": 1, "unit_price": 5000, "vat_rate": 15}]
      },
      {
        "invoice_no": "INV-1002",
        "buyer_name": "Beta Corp",
        "items": [{"description": "Service B", "quantity": 2, "unit_price": 3000, "vat_rate": 15}]
      }
    ]
  }'

Response 201

{
  "created": 2,
  "failed": 0,
  "documents": [
    { "index": 0, "id": "uuid", "serial": "MUSHAK-6.3/2026/000101", "qr_token": "...", "verify_url": "..." },
    { "index": 1, "id": "uuid", "serial": "MUSHAK-6.3/2026/000102", "qr_token": "...", "verify_url": "..." }
  ],
  "errors": []
}

Returns 429 if you don't have enough credits for the whole batch. Partial failures are reported per-item in errors.

Upload an invoice image URL — AI extracts Mushak-6.3 fields.

curl -X POST https://mushak.globyn.com/api/public/v1/extract \
  -H "Authorization: Bearer mbk_..." \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/invoice.jpg"}'

Response 200

{
  "extracted": {
    "invoice_no": "INV-1042",
    "invoice_date": "2026-05-19",
    "buyer_name": "Acme Ltd",
    "buyer_bin": "001234567-0202",
    "items": [...]
  }
}

Pipe the result into POST /documents to create the challan.

List your documents (newest first). Query: ?limit=50 (max 200).

curl https://mushak.globyn.com/api/public/v1/documents?limit=20 \
  -H "Authorization: Bearer mbk_..."

Fetch a single document by id.

curl https://mushak.globyn.com/api/public/v1/documents/UUID \
  -H "Authorization: Bearer mbk_..."

Public verification of a QR token. No auth required.

curl https://mushak.globyn.com/api/public/v1/verify/QR_TOKEN