Section A: Current State

What APIs are used today?

Q1: Which government APIs does SIDF Client Portal currently integrate with?

API	Integrated?	Used For
Nafath	Yes / No	Yes
Wathiq	Yes / No	No
GOSI	Yes / No	Yes
SIMAH	Yes / No	Yes
National Address	Yes / No	Yes
MISA	Yes / No	Yes
Bayan	Yes / No	No
Qawaem	Yes / No	No
SBC		No
Riga		No
minister of justice		Yes
Naba2
Yaqeen		based on request
Sanction api
moj		yes
offline sps		needs research

Q2: For each integrated API:

• When was it integrated?
• Who maintains it?
• What is the current usage volume?
• What is the error/failure rate?

How is data fetched?

Q3: Is data fetched at form load or on-demand?

• Example: When user enters CR, does system auto-fetch immediately? yes
• Or does user click a "Verify" button?

Q4: Is there any caching of API responses? no

• How long is data cached?
• Is cache shared across users?
• Cache invalidation strategy?

Separate or Unified?

Q5: Are APIs integrated separately or through a unified gateway?

`Option A: Separate Integration

Client Portal ──► Wathiq API ──► GOSI API ──► MISA API ──► Address API

Option B: Unified Gateway

Client Portal ──► API Gateway ──► All APIs

Option C: Aggregator (like SME Profile)

Client Portal ──► SME Profile ──► (They call all APIs)`

Which approach is currently used?

Section B: Limitations & Challenges

Technical Limitations

Q6: What technical challenges exist with current API integrations?

• Response time issues?
• Frequent timeouts?
• Data format inconsistencies?
• Authentication complexity?

Q7: Are there rate limits that cause problems?

• Which APIs have strict limits?
• Have limits been exceeded before?
• What happens when exceeded?

Q8: How are API failures handled today?

• Retry logic?
• Fallback to manual entry?
• Error logging?
• User notification?

Data Limitations

Q9: Are there data quality issues from APIs?

• Missing fields?
• Outdated information?
• Inconsistent formats (dates, numbers)?
• Arabic/English inconsistencies?

Q10: How is data conflict resolved?

• API returns different value than user entered
• Two APIs return conflicting data
• Which source is trusted?

Maintenance Burden

Q11: What is the maintenance effort for current integrations?

• How often do APIs change?
• How are changes communicated?
• Average time to fix breaking changes?
• Dedicated team or shared responsibility?