Skip to main content

Frequently Asked Questions

Common questions and answers about Najeeb Health Suite.

General​

What is Najeeb Health Suite?​

Najeeb Health Suite is a SaaS API platform designed for insurance companies in the Kingdom of Saudi Arabia. It provides APIs for managing healthcare data, including patients, claims, providers, and authorizations.

Who can use Najeeb Health Suite?​

Najeeb Health Suite is designed for insurance companies operating in KSA. To get started, you'll need to sign up and receive API credentials.

Is there a free tier?​

Yes, we offer a free tier for development and testing. Contact us for production access and enterprise plans.

What languages are supported?​

The API is language-agnostic (REST).

Authentication​

How do I get API credentials?​

After signing up for Najeeb Health Suite, you'll receive your Client ID and Client Secret in the dashboard.

Can I use the same token for multiple requests?​

Yes, you can reuse the same access token for multiple requests until it expires.

What if my token expires?​

If your token expires, you'll receive a 401 Unauthorized response. Simply request a new token and retry the request.

API Usage​

What is the rate limit?​

  • Standard Tier: 1,000 requests per minute
  • Enterprise Tier: Custom limits based on your needs

What happens if I exceed the rate limit?​

You'll receive a 429 Too Many Requests response. The response includes headers indicating when you can retry:

  • X-RateLimit-Reset: Unix timestamp when the limit resets

What data formats are supported?​

All requests and responses use JSON format with UTF-8 encoding.

Do you support Arabic text?​

Yes, the API fully supports Arabic text and RTL (right-to-left) text. Include the Accept-Language: ar header for Arabic responses.

How do I handle pagination?​

List endpoints support pagination with page and per_page parameters. Responses include pagination metadata:

{
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 100,
    "total_pages": 5
  }
}

Can I update a claim after submission?​

Claims can only be updated if their status is pending. Once a claim enters processing or a later status, it cannot be modified.

How do I check if a patient already exists?​

Use the national_id parameter when listing patients:

const patients = await client.patients.list({ national_id: '1234567890' });

If a patient with that national ID exists, it will be returned in the results.

Webhooks​

How do I set up webhooks?​

  1. Configure your webhook URL in the Najeeb dashboard
  2. Select which events you want to receive
  3. Implement a webhook endpoint that verifies signatures
  4. Process incoming events

See the Webhooks documentation for details.

How do I verify webhook signatures?​

Each webhook request includes a signature in the X-Najeeb-Signature header. Use your webhook secret to verify the signature.

What happens if my webhook endpoint is down?​

Najeeb Health Suite will retry failed webhook deliveries:

  • Retry Schedule: 1 minute, 5 minutes, 15 minutes, 1 hour, 6 hours
  • Max Retries: 5 attempts
  • Timeout: 30 seconds per request

Can I test webhooks locally?​

Yes, use ngrok or similar tools to expose your local server:

ngrok http 3000

Use the ngrok URL in your webhook configuration.

Data and Privacy​

Is my data secure?​

Yes, Najeeb Health Suite uses:

  • OAuth 2.0 for authentication
  • HTTPS for all API communications
  • Industry-standard encryption
  • Compliance with KSA healthcare regulations

Where is data stored?​

Data is stored in secure data centers in the Kingdom of Saudi Arabia, ensuring compliance with local data residency requirements.

Can I export my data?​

Yes, contact support to request a data export. We can provide your data in standard formats (JSON, CSV).

How long is data retained?​

Data retention policies vary by data type. Contact support for specific retention periods.

Integration​

How long does integration take?​

Integration time varies based on your requirements:

  • Basic Integration: 1-2 days
  • Full Integration: 1-2 weeks
  • Custom Requirements: Varies

Do you provide integration support?​

Yes, we offer integration support for all customers. Contact support@najeeb.ai for assistance.

Can I use this with my existing system?​

Yes, Najeeb Health Suite is designed to integrate with existing insurance systems through REST APIs and webhooks.

Do you have a sandbox environment?​

Yes, we provide a sandbox environment for testing. Contact support to get sandbox credentials.

Billing​

How is pricing structured?​

Pricing is based on:

  • API usage (requests per month)
  • Number of patients/claims
  • Support level

Contact sales for detailed pricing information.

How do I upgrade my plan?​

Contact support or use the dashboard to upgrade your plan.

Support​

How do I get help?​

  • Email: support@najeeb.ai
  • Documentation: Browse our comprehensive guides
  • Status Page: Check system status at status.najeeb.com

What are your support hours?​

Standard support hours are Sunday-Thursday, 9 AM - 5 PM (KSA time). Enterprise customers have 24/7 support.

How do I report a bug?​

Report bugs via email to support@najeeb.ai or through the dashboard. Include:

  • Request/response details
  • Error messages
  • Steps to reproduce

Next Steps​