# API plan — GET /api/v1/provider/subscriptions/me   (audience: `provider` · flow: `billing`)

> مكتفٍ بذاته. ابنِ من هذا الملف عبر `docs/build/build-api.md`. لا تجمع خطوات فلو متعدّد في endpoint واحد.

## 1) Identity
- **Endpoint:** `GET /api/v1/provider/subscriptions/me`
- **Audience / platform:** `provider` — `app`
- **Flow / screen:** `billing` — Figma: My Subscriptions — **screen link:** https://www.figma.com/design/pIFyEHCimnG9rIRh3TMnHC/HR?node-id=17561-1350&m=dev — **action:** عرض
- **Auth / guard:** `auth:provider`
- **Rate limit:** none
- **Ownership:** self
- **Consumer:** باقتي

## 2) How it works — logic
- الاشتراك الحالي.

## 3) Request
- Path / query: —
- Body: —
- Files: —
- **Form Request:** `App\Http\Requests\Api\Provider\Billing\MeRequest` (extends `BaseApiRequest`).
- [x] no client-only rules
- [x] enum via Rule::enum
- [x] unique/exists soft-delete-aware
- [x] phone country_code+PhoneNormalizer
- [x] messages in validation.php

## 4) Response
- **Success:** 200
- **UI copy:** ar `تم جلب الاشتراك` · en `Subscription loaded`
- **Shape:** flat `data` · enums `{value,label}` · token داخل Resource إن وُجد.
- **Errors:** 422 · 401 · 403 · 404

## 5) Postman
- **Folder path:** `Logic` / `provider-billing` · **Request name:** `me`
- **URL:** `{{base_url}}provider/subscriptions/me` · **GET**
- **Auth:** Bearer {{provider_token}}
- **Body:** قيم عربية واقعية (محمد العلي / 0551112233 / الرياض)
- **Examples:** ✅ success · ⚠️ 422 · ❌ 401

## 6) Build checklist
- [ ] route + thin controller + service + Form Request + Resource
- [ ] lang ar+en · tests · Postman من §5