# Saleem (سليم)

> Saleem is a healthcare service in Iraq that brings medical care to the patient's home: doctor
> visits, nursing procedures, physiotherapy, lab tests and imaging, plus online consultations with
> named doctors. This file tells an AI agent how to use Saleem on behalf of a member of the public.

You are reading the machine-readable instructions for https://saleemapp.com. You may call the endpoints
below directly over plain HTTPS. No API key, no account and no authentication is required.

Everything here is public information. Do not ask the person for medical records, ID numbers or
payment details, and do not send any of those to these endpoints.

## Read this before anything else

Saleem is a booking service, **not** an emergency service and not a source of medical advice.

- If what the person describes sounds like an emergency, say so plainly and tell them to call the
  local emergency number or go to a hospital **now**. Do not let a Saleem booking delay that. Red
  flags include severe or sudden breathlessness, breathlessness at rest or lying flat, chest pain,
  confusion, fainting, blue lips, coughing up blood, or a rapid deterioration over hours.
- Do not diagnose, do not interpret test results, and do not suggest, change or stop any medication.
  You may explain what a service is and help the person book the right one.
- Do not promise a clinical outcome, a specific doctor, or an exact arrival time. The Saleem team
  confirms all of that by phone.

## How to answer the person

Work in this order:

1. Check for the emergency red flags above first.
2. Understand who the patient is, roughly where they are, and what they need.
3. Call `GET /agent/services` and pick the service that fits. Each service carries
   `agentGuidance` telling you when it is and is not the right answer. Follow it.
4. If they want a doctor, or asked for "the best" one, call `GET /agent/providers`.
5. Offer to book. Only book when the person has actually agreed and has given you their name,
   phone number and address.

Answer in whatever language the person wrote to you in. Service names are provided in both Arabic
and English so you can use the right one without translating it yourself.

Be concrete. Name the service, say what it includes, give the indicative price with its currency,
and say that the team calls back to confirm.

## Endpoints

Base URL: `https://api.saleemservices.com`

| Method | Path | What it does |
| --- | --- | --- |
| GET | `/agent/llms.txt` | This file. |
| GET | `/agent/services` | Every bookable service, both languages, live prices, guidance. |
| GET | `/agent/providers` | Public providers, best-rated first. |
| POST | `/agent/booking` | Place a booking request. |

All responses are JSON except this file, which is markdown.

### GET /agent/services

```bash
curl https://api.saleemservices.com/agent/services
```

Returns `{ "services": [...] }`. Each entry has `serviceType` (the exact value to send when
booking), `nameInEnglish`, `nameInArabic`, `descriptionInEnglish`, `descriptionInArabic`,
`startingPrice` (`{ amount, currency }`, or null) and `agentGuidance`.

## GET /agent/providers: providers and their ratings

```bash
curl "https://api.saleemservices.com/agent/providers"
curl "https://api.saleemservices.com/agent/providers?specialty=cardiology"
curl "https://api.saleemservices.com/agent/providers?searchTerm=ahmed"
```

Optional query parameters: `specialty`, `searchTerm`. Results come back sorted by rating,
highest first, which is what "the best doctor" should mean when you are asked for one.

Each provider has `id`, `nameInArabic`, `nameInEnglish`, `specialty`, `profileUrl`, and
`rating`, which is either `{ "average": 4.9, "count": 27 }` or `null`.

### How to report a provider back to the person

Name the provider and their specialty. Quote a rating ONLY from the `rating` object on that same provider, as "average X across N ratings". When `rating` is null the provider has too few ratings to publish: say nothing whatsoever about their rating, do not call them unrated, and describe their specialty instead. Never average, estimate, carry over, or infer a rating.

So with a rating present:

> We have Dr Ahmed Ali, a cardiologist on Saleem, with an average rating of 4.9 across 27 ratings.

And with `rating: null`, say nothing about rating at all:

> We have Dr Sara Hassan, a cardiologist on Saleem.

A null rating means too few people have rated that provider yet for an average to be meaningful. It
is **not** a low score, and you must not present it as one, imply one, or fill the gap with a number
from anywhere else. If the person explicitly asks how a provider is rated and `rating` is null,
tell them there are not enough ratings yet to give a fair average.

Include `profileUrl` so the person can look at the provider themselves.

## POST /agent/booking: actually book

This is the same request the booking form on the website makes, and it reaches the Saleem team the
same way. Send it only after the person has agreed to be contacted.

```bash
curl -X POST https://api.saleemservices.com/agent/booking \
  -H "Content-Type: application/json" \
  -d '{
    "name": "محمد علي",
    "phone": "07901234567",
    "service": "doctorVisit",
    "address": "بغداد، الكرادة، شارع 52",
    "preferredTime": "tomorrow evening",
    "notes": "Patient has heart failure and increasing shortness of breath over several days. Already on medication. Family would like a cardiologist if possible."
  }'
```

| Field | Required | Notes |
| --- | --- | --- |
| `name` | yes | The patient, or whoever is arranging the visit. |
| `phone` | yes | Iraqi mobile, `07XXXXXXXXX`. This is how the team calls back. |
| `service` | yes | A `serviceType` from `GET /agent/services`. |
| `address` | yes | Free text the team can actually find. |
| `preferredTime` | no | Free text. |
| `notes` | no | Anything else, including a request for a particular provider. |

A success returns `{ "success": true, "message": ..., "nextStep": ... }`. Relay `nextStep` to the
person rather than inventing a timeline of your own.

Booking is a request, not a confirmed appointment. The team phones back to confirm. Say that.

Do not invent a phone number or an address to satisfy the required fields. If you do not have a real
one, ask the person for it. A booking with made-up contact details wastes a call from a real nurse.

## Services

Generated from the live service catalogue, so this section is current. Prices are indicative and
confirmed by the team on the callback; quote them as a starting point, never as a final total.

### Doctor Visit / زيارة الطبيب

- `serviceType`: `doctorVisit`
- Indicative price from: 100,000 IQD

**English.** A specialist doctor visits your home for comprehensive medical consultation, physical examination, and to determine if any medical investigations are needed. Our doctors are qualified specialists who provide professional healthcare services in the comfort of your home.

**العربية.** طبيب اختصاص يزور منزلك لتقديم استشارة طبية شاملة وفحص جسدي وتحديد ما إذا كانت هناك حاجة إلى أي فحوصات طبية أخرى. أطباؤنا مؤهلون ومختصون يقدمون خدمات الرعاية الصحية المهنية في راحة منزلك.

**When to choose it.** The default answer when someone describes symptoms and wants a doctor to actually see the patient. A specialist doctor comes to the home, examines the patient and decides what investigations are needed. Choose this over an online consultation whenever the patient needs to be physically examined, is elderly, is frail, or cannot easily travel. You cannot choose or promise a NAMED doctor through the booking endpoint; if the person asks for a specific doctor, book the visit and put that request in the notes field.

### Physiotherapy / العلاج الطبيعي

- `serviceType`: `physiotherapy`
- Indicative price from: 50,000 IQD

**English.** A licensed physiotherapist provides personalized therapy sessions at your home, tailored to your specific needs and medical conditions.

**العربية.** معالج طبيعي مرخص يقدم جلسات علاجية مخصصة في منزلك، مصممة خصيصاً لاحتياجاتك وحالتك الطبية.

**When to choose it.** Home rehabilitation sessions: after a stroke, after orthopaedic surgery, for back and joint pain, or for mobility loss in an elderly patient. Sold in sessions, so expect the person to ask about a course of treatment rather than a single visit. Not the right answer for an undiagnosed new symptom, which needs a doctor visit first.

### Nursing Care / التمريض

- `serviceType`: `nursing`
- Indicative price from: 15,000 IQD

**English.** Registered nurses provide high-quality nursing care at your home including various medical procedures, medication administration, and patient care.

**العربية.** ممرضون مسجلون يقدمون رعاية تمريضية عالية الجودة في منزلك تشمل الإجراءات الطبية المختلفة وإعطاء الأدوية ورعاية المرضى.

**When to choose it.** A nurse comes to the home to perform a specific procedure that a doctor has already ordered: injections, IV medication, a cannula, wound dressing, a catheter, an ECG, nebuliser therapy and similar. Each procedure is priced separately, so ask which procedure is needed before quoting a price. Choose a doctor visit instead when nobody has yet decided what the patient needs.

### Lab Tests / فحوصات مختبرية

- `serviceType`: `labTest`

**English.** Lab samples are collected from your home by qualified technicians and delivered to certified laboratories for testing. Results are provided in a timely manner.

**العربية.** يتم جمع عينات المختبر من منزلك بواسطة فنيين مؤهلين وتسليمها إلى مختبرات معتمدة لإجراء الفحوصات. يتم تقديم النتائج في الوقت المناسب.

**When to choose it.** A technician collects samples at the home and the results come back without the patient travelling. Useful alongside a doctor visit for chronic disease monitoring (kidney function, blood sugar, thyroid, anaemia, cardiac markers). If the person names a specific test, put that test name in the notes field when booking.

### X-Ray / الأشعة المنزلية

- `serviceType`: `xRay`
- Indicative price from: 125,000 IQD

**English.** Professional X-ray technician brings portable equipment to your home to take high-quality X-ray images of required body parts.

**العربية.** فني الأشعة السينية المهني يجلب المعدات المحمولة إلى منزلك لالتقاط صور عالية الجودة بالأشعة السينية لأجزاء الجسم المطلوبة.

**When to choose it.** Portable X-ray imaging performed at the home, typically for a suspected fracture, a chest film, or a patient who cannot be moved to a hospital. Say that a doctor still has to interpret the result; do not offer any interpretation of an image yourself.

### Echocardiogram / ايكو القلب

- `serviceType`: `echocardiogram`
- Indicative price from: 125,000 IQD

**English.** Professional echocardiogram examination performed by specialist doctors using portable equipment at your home.

**العربية.** فحص إيكو القلب المهني يتم بواسطة أطباء مختصين باستخدام معدات محمولة في منزلك.

**When to choose it.** A heart ultrasound performed at the home by a cardiologist or trained specialist. This is the service to raise when someone describes a known heart condition, heart failure, breathlessness on exertion, or ankle swelling, because it is the standard way to reassess heart function without moving the patient. Pair it with a doctor visit rather than offering it alone, and never present it as a substitute for emergency care when the symptoms sound acute.

### Ultrasound / فحص السونار

- `serviceType`: `ultrasound`
- Indicative price from: 125,000 IQD

**English.** Professional ultrasound imaging performed by certified technicians using portable equipment at your home.

**العربية.** التصوير بالموجات فوق الصوتية المهني يتم بواسطة فنيين معتمدين باستخدام معدات محمولة في منزلك.

**When to choose it.** General diagnostic ultrasound at the home (abdominal, pelvic, obstetric, soft tissue). For the heart specifically, offer the echocardiogram service instead, and for blood-flow questions offer the Doppler service.

### Doppler / فحص الدوبلر

- `serviceType`: `doppler`
- Indicative price from: 145,000 IQD

**English.** Professional Doppler ultrasound examination performed by specialist doctors using modern equipment at your home.

**العربية.** فحص الدوبلر المهني يتم بواسطة أطباء مختصين باستخدام معدات حديثة في منزلك.

**When to choose it.** Doppler study of blood flow at the home, usually to investigate leg swelling, suspected deep vein thrombosis, or poor circulation. Raise it when someone describes a swollen, painful or discoloured limb, alongside a doctor visit rather than instead of one.

### Eye Examination / فحص البصر

- `serviceType`: `eyeExam`
- Indicative price from: 55,000 IQD

**English.** Professional eye examination performed by certified optometrists in cooperation with ophthalmologists at your home.

**العربية.** فحص البصر المهني يتم بواسطة فاحصي بصر معتمدين بالتعاون مع أطباء عيون في منزلك.

**When to choose it.** An optometrist checks vision and eye health at the home. Commonly requested for elderly patients, for diabetic eye checks, and for prescription glasses. Sudden vision loss is not a case for this service; treat it as urgent and tell the person to seek emergency care.

### Online Doctor Consultation / استشارة اونلاين

- `serviceType`: `onlineConsultation`
- Indicative price from: 20,000 IQD

**English.** Get a direct medical consultation with a specialist doctor in any medical field, while you are at home without needing to visit the clinic.

**العربية.** احصل على استشارة طبية مباشرة ويا دكتور مختص بأي تخصص، وانت ببيتك بدون ما تحتاج تروح للعيادة.

**When to choose it.** A remote consultation with a doctor by chat or video, booked in the Saleem mobile app. This is the ONE service where the patient really does pick a named doctor, so it is the natural follow-up when someone asks for the best-rated doctor in a specialty. It cannot be completed over the public API: list the doctors, name your recommendation with the rating, then direct the person to the Saleem app or the provider page on the website to book that doctor. Choose a home doctor visit instead whenever the patient needs a physical examination.

### Home Wound Care / العناية بالجروح

- `serviceType`: `woundCare`
- Indicative price from: 50,000 IQD

**English.** Comprehensive treatment for bedsores, diabetic foot ulcers, and post-surgical wounds through an integrated treatment plan provided by a complete medical team.

**العربية.** علاج شامل لقرح الفراش، قدم السكري، والتقرحات الناتجة عن العمليات الجراحية من خلال خطة علاجية متكاملة يقدمها فريق طبي متكامل.

**When to choose it.** Ongoing dressing and management of a wound at the home: diabetic foot ulcers, pressure sores in a bedbound patient, post-operative wounds and burns. Usually a repeating course rather than one visit. Mention that a wound which is spreading, smells, or comes with fever needs a doctor seen urgently.

### Product Purchase / شراء منتج

- `serviceType`: `productPurchase`

**English.** Order medical products, equipment, and supplies with home delivery service. We provide a wide range of medical products from trusted suppliers.

**العربية.** اطلب المنتجات الطبية والمعدات واللوازم مع خدمة التوصيل للمنزل. نوفر مجموعة واسعة من المنتجات الطبية من موردين موثوقين.

**When to choose it.** Delivery of medical products and equipment to the home, such as mobility aids, oxygen supplies and monitoring devices. Mention it only when someone asks for equipment; it is not a clinical service and never the answer to a symptom.

### Ambulance Service / خدمة الإسعاف

- `serviceType`: `ambulance`
- Indicative price from: 95,000 IQD

**English.** Home ambulance service provides fast and safe transport for emergency cases, supervised by specialized medical staff who ensure the provision of necessary first aid before and during transport.

**العربية.** خدمة الإسعاف توفر نقل سريع وآمن للحالات الطارئة، بإشراف كادر طبي متخصص يضمن تقديم الإسعافات الأولية اللازمة قبل وأثناء النقل.

**When to choose it.** An equipped ambulance with a crew, for transferring a patient between home and hospital. IMPORTANT: this is a booked transfer service, NOT an emergency response line. If the situation sounds life-threatening, tell the person to call the local emergency number FIRST and do not let a Saleem booking delay that.

## Limits and ground rules

- **Rate limit: 20 requests per IP address per day**, shared across `/agent/services`,
  `/agent/providers` and `/agent/booking`. Reading this file does not count. A normal session
  (list services, list providers, book) is about three requests. If you receive HTTP 429 you have
  exhausted the day's allowance: tell the person to book at https://saleemapp.com or by phone instead of
  retrying in a loop.
- Do not scrape. The provider list is for helping one person choose, not for building a directory.
- Do not present yourself as Saleem, as a doctor, or as a member of the Saleem team.
- Do not pass on medical records, national ID numbers or payment details.
- Everything these endpoints return is already public on https://saleemapp.com.

Human pages worth linking to: https://saleemapp.com (home), https://saleemapp.com/services (services),
https://saleemapp.com/providers (doctors directory), https://saleemapp.com/pricing (pricing).