VitaHub API v1

GET /v1/search/diagnoses?q=hipert&limit=5

{
  "success": true,
  "data": {
    "results": [
      {
        "code": "I10",
        "name": "Esencijalna (primarna) hipertenzija",
        "category": "Bolesti sistema krvotoka"
      },
      {
        "code": "I11",
        "name": "Hipertenzivna bolest srca",
        "category": "Bolesti sistema krvotoka"
      }
    ],
    "totalFound": 2
  }
}

GET /v1/search/procedures?q=CT%20grudnog

{
  "success": true,
  "data": {
    "results": [
      {
        "id": 101,
        "name": "CT grudnog koša",
        "level": "diagnostic",
        "isExamination": false
      },
      {
        "id": 102,
        "name": "CT grudnog koša sa kontrastom",
        "level": "diagnostic",
        "isExamination": false
      }
    ],
    "totalFound": 2
  }
}

GET /v1/search/specialties?q=kardio

{
  "success": true,
  "data": {
    "results": [
      {
        "id": 12,
        "name": "Kardiologija",
        "level": "subspecialty"
      },
      {
        "id": 45,
        "name": "Interventna kardiologija",
        "level": "narrowSubspecialty"
      }
    ],
    "totalFound": 2
  }
}

GET /v1/search/symptoms?q=bol%20u%20grudima

{
  "success": true,
  "data": {
    "results": [
      {
        "id": 201,
        "name": "Bol u grudima",
        "category": "Kardiovaskularni simptomi"
      },
      {
        "id": 202,
        "name": "Bol u grudima pri disanju",
        "category": "Respiratorni simptomi"
      }
    ],
    "totalFound": 2
  }
}

GET /v1/search/doctors?q=Marko&id=12&level=specijalnost

{
  "success": true,
  "data": {
    "results": [
      {
        "id": 349,
        "fullName": "Dr Marko Marković",
        "specialties": [
          { "name": "Neurologija", "level": "subspecialty" }
        ],
        "currentInstitutions": [
          {
            "name": "KBC Zemun",
            "address": "Vukova 9, Beograd"
          }
        ]
      },
      {
        "id": 512,
        "fullName": "Dr Marko Nikolić",
        "specialties": [
          { "name": "Interna medicina", "level": "specialty" },
          { "name": "Kardiologija", "level": "subspecialty" }
        ],
        "currentInstitutions": [
          {
            "name": "BelMedic",
            "address": "Koste Jovanovića 87, Beograd"
          }
        ]
      }
    ],
    "totalFound": 2
  }
}

GET /v1/search/doctors?q=Marko&id=12&level=subspecijalnost

{
  "patientAge": 35,
  "patientGender": "musko",
  "diagnosisCode": "I10",
  "desiredLocation": "Beograd",
  "preferredLanguages": ["srpski", "engleski"],
  "page": 1,
  "limit": 10
}

{
  "success": true,
  "data": {
    "recommendations": [ /* Recommendation objekti */ ],
    "totalFound": 5,
    "searchSummary": {
      "diagnosisName": "Povisen krvni pritisak",
      "patientProfile": "Odrastao, muskarci, 35 god.",
      "searchCriteria": ["Dijagnoza: I10", "Lokacija: Beograd"]
    },
    "page": 1,
    "hasMore": false
  },
  "metadata": {
    "timestamp": "2026-03-31T10:00:00.000Z",
    "processingTimeMs": 556
  }
}

{
  "patientAge": 45,
  "patientGender": "zenski",
  "symptoms": "Imam jak bol u grudima koji se siri u levu ruku.",
  "desiredLocation": "Novi Sad",
  "preferredLanguages": ["engleski"]
}

{
  "patientAge": 45,
  "patientGender": "zenski",
  "symptoms": "Imam jak bol u grudima koji se siri u levu ruku.",
  "additionalQuestions": [
    {
      "question": "Da li se bol pojacava pri disanju?",
      "answer": "Da"
    }
  ]
}

{
  "success": true,
  "status": "NEEDS_MORE_INFO",
  "message": "Additional information is required for a more precise diagnosis.",
  "data": {
    "additionalQuestionAI": [
      "Kada je bol poceo?",
      "Da li imate gusenje?"
    ],
    "reason": "Potrebno je vise podataka za precizniju preporuku."
  }
}

{
  "success": true,
  "status": "DOCTORS_FOUND",
  "data": {
    "recommendations": [ /* Recommendation objekti */ ],
    "totalFound": 3,
    "searchSummary": {
      "diagnosisName": "Akutni koronarni sindrom",
      "patientProfile": "odrasli, zene",
      "searchCriteria": ["Interventna kardiologija"]
    }
  },
  "aiMetadata": {
    "isUrgent": true,
    "summary": "Preporucuje se hitan pregled kod interventnog kardiologa.",
    "recommendations": [
      {
        "type": "subSpecialty",
        "name": "Interventna kardiologija",
        "recommendedLevel": "subspecialty",
        "id": 123,
        "reason": "Simptomi ukazuju na akutni koronarni sindrom."
      }
    ]
  }
}

{
  "patientAge": 32,
  "patientGender": "musko",
  "symptoms": "Vrtoglavica i trnjenje leve ruke vec 2 dana",
  "desiredLocation": "Beograd",
  "preferredLanguages": ["srpski"],
  "preferredDoctor": {
    "firstName": "Marko",
    "lastName": "Markovic",
    "specialization": "neurolog"
  }
}

{
  "success": true,
  "status": "WANTED_DOCTOR_MATCH",
  "message": "Zeljeni doktor je pronadjen i moze da vam pomogne",
  "data": {
    "recommendations": [ /* Recommendation objekti */ ],
    "totalFound": 1
  }
}

{
  "success": true,
  "status": "DOCTOR_NOT_FOUND",
  "message": "Trenutno doktor kog ste trazili nije deo VitaHub sistema."
}

{
  "patientAge": 40,
  "patientGender": "musko",
  "desiredLocation": "Beograd",
  "preferredLanguages": ["srpski"],
  "procedure": "Kardioloski pregled",
  "page": 1,
  "limit": 10
}

{
  "patientAge": 40,
  "patientGender": "musko",
  "searchItems": [
    {
      "id": 101,
      "name": "CT grudnog kosa",
      "level": "diagnostic",
      "isExamination": false
    }
  ],
  "specialtyItems": [
    {
      "id": 12,
      "name": "Radiologija",
      "level": "specialty"
    }
  ]
}

{
  "success": true,
  "data": {
    "recommendations": [ /* Recommendation objekti */ ],
    "totalFound": 12,
    "searchSummary": {
      "procedureName": "CT grudnog kosa",
      "patientProfile": "Odrastao, muskarci, 40 god.",
      "searchCriteria": ["Lokacija: Beograd", "Jezici: srpski"]
    },
    "page": 1,
    "hasMore": true
  },
  "metadata": {
    "timestamp": "2026-03-31T10:00:00.000Z",
    "processingTimeMs": 420
  }
}

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Opis greske."
  },
  "metadata": {
    "timestamp": "2026-03-31T10:00:00.000Z",
    "requestId": "uuid"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation failed.",
    "details": [
      {
        "field": "diagnosisCode",
        "message": "Diagnosis code is required."
      },
      {
        "field": "patientGender",
        "message": "Must be one of: muski, musko, m, male, zenski, zensko, z, female."
      }
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "AI_SERVICE_ERROR",
    "message": "Symptom analysis service is temporarily unavailable. Please retry."
  }
}

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1711900800

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Retry after 42 seconds."
  }
}

curl "https://api.vitahub.rs/v1/search/symptoms?q=bol%20u%20grudima" \
  -H "X-API-Key: YOUR_API_KEY"

curl "https://api.vitahub.rs/v1/search/doctors?q=Marko&id=12&level=specijalnost" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.vitahub.rs/v1/diagnosis-doctor" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "patientAge": 35,
    "patientGender": "musko",
    "diagnosisCode": "I10"
  }'

curl -X POST "https://api.vitahub.rs/v1/symptom-doctor" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "patientAge": 45,
    "patientGender": "zenski",
    "symptoms": "Imam bol u grudima i nedostatak vazduha"
  }'

curl -X POST "https://api.vitahub.rs/v1/wanted-doctor" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "patientAge": 32,
    "patientGender": "musko",
    "symptoms": "Vrtoglavica i trnjenje leve ruke vec 2 dana",
    "preferredDoctor": { "firstName": "Marko", "lastName": "Markovic" }
  }'

curl -X POST "https://api.vitahub.rs/v1/procedures-doctor" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "patientAge": 40,
    "patientGender": "musko",
    "procedure": "Kardioloski pregled"
  }'