{"openapi":"3.1.0","info":{"title":"StudiePoint AI: Scholarship & Visa API","description":"Studie by StudiePoint gives African postgraduate students access to 346 verified full-ride scholarships across 28 countries, visa accessibility data for 54 African nationalities, and GPA conversion from African grading systems to the international 4.0 scale. Use findScholarships to match a student profile to real programmes, checkVisa to confirm passport eligibility before applying, and convertGpa to translate an African grade to the 4.0 scale universities expect. All scholarships are fully funded. No partial grants, no loans.","version":"1.0.0"},"servers":[{"url":"https://studiepoint.ai","description":"StudiePoint AI production server"}],"paths":{"/api/match":{"post":{"operationId":"findScholarships","summary":"Find matching full-ride scholarships for a student profile","description":"Returns ranked full-ride scholarships matching the student's nationality, GPA, and field of study. Results include match percentage, probability, visa accessibility, deadline, and reasons the student qualifies. Use when a student asks which scholarships they qualify for.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["nationality","gpa","fieldOfStudy"],"properties":{"nationality":{"type":"string","description":"The student's African nationality","enum":["Algerian","Angolan","Beninese","Bissau-Guinean","Botswanan","Burkinabe","Burundian","Cameroonian","Cape Verdean","Central African","Chadian","Comorian","Congolese (DRC)","Congolese (Republic)","Djiboutian","Egyptian","Equatoguinean","Eritrean","Ethiopian","Gabonese","Gambian","Ghanaian","Guinean","Ivorian","Kenyan","Liberian","Libyan","Malagasy","Malawian","Malian","Mauritanian","Mauritian","Moroccan","Mosotho","Mozambican","Namibian","Nigerian","Nigerien","Rwandan","São Toméan","Senegalese","Seychellois","Sierra Leonean","Somali","South African","South Sudanese","Sudanese","Swazi","Tanzanian","Togolese","Tunisian","Ugandan","Zambian","Zimbabwean"]},"gpa":{"type":"number","minimum":0,"maximum":4,"description":"The student's GPA on the 4.0 scale. Use the convertGpa tool first if the student only knows their grade in an African system."},"fieldOfStudy":{"type":"string","description":"The student's intended field of study","enum":["Computer Science","Engineering","Business","Medicine","Law","Sciences","Arts & Humanities","Social Sciences","Mathematics","Education","Architecture","Environmental Science","Public Health","Economics","International Relations"]},"graduationYear":{"type":"integer","description":"The year the student completed their undergraduate degree (optional)","minimum":1980,"maximum":2026}}}}}},"responses":{"200":{"description":"Ranked list of matching scholarships","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Scholarship or programme name"},"country":{"type":"string","description":"Host country"},"programName":{"type":"string","description":"Specific programme or funding body"},"scholarshipAmount":{"type":"string","description":"What the scholarship covers"},"matchPercent":{"type":"integer","description":"How well the student profile fits (0-100)"},"scholarshipProbability":{"type":"integer","description":"Estimated probability of success (0-100)"},"visaStatus":{"type":"string","enum":["green","yellow","red"],"description":"Visa accessibility for this nationality/country pair"},"deadline":{"type":"string","description":"Application deadline"},"essayType":{"type":"string","description":"Type of essay required"},"reasoning":{"type":"array","items":{"type":"string"},"description":"Specific reasons why this scholarship matches the student"}}}}}}}}}},"/api/visa-policies/check":{"get":{"operationId":"checkVisa","summary":"Check visa accessibility for a nationality applying to a specific country","description":"Returns visa status, processing time, visa type, post-study work rights, and document checklist for an African nationality in a destination country. Green = straightforward, yellow = moderate difficulty, red = restricted. Use when a student asks if their passport works for a country.","parameters":[{"name":"nationality","in":"query","required":true,"description":"The student's African nationality","schema":{"type":"string","enum":["Algerian","Angolan","Beninese","Bissau-Guinean","Botswanan","Burkinabe","Burundian","Cameroonian","Cape Verdean","Central African","Chadian","Comorian","Congolese (DRC)","Congolese (Republic)","Djiboutian","Egyptian","Equatoguinean","Eritrean","Ethiopian","Gabonese","Gambian","Ghanaian","Guinean","Ivorian","Kenyan","Liberian","Libyan","Malagasy","Malawian","Malian","Mauritanian","Mauritian","Moroccan","Mosotho","Mozambican","Namibian","Nigerian","Nigerien","Rwandan","São Toméan","Senegalese","Seychellois","Sierra Leonean","Somali","South African","South Sudanese","Sudanese","Swazi","Tanzanian","Togolese","Tunisian","Ugandan","Zambian","Zimbabwean"]}},{"name":"country","in":"query","required":true,"description":"The destination country the student wants to study in","schema":{"type":"string","enum":["Canada","USA","UK","France","Europe","Belgium","Japan","South Korea","China","South Africa","Pan-African","Australia","New Zealand","Ireland","Italy","Spain","Indonesia","Brazil","Malaysia","Singapore","Taiwan","Hong Kong","Finland","Saudi Arabia","India","Netherlands","UAE","Morocco"]}}],"responses":{"200":{"description":"Visa accessibility details for this nationality and destination","content":{"application/json":{"schema":{"type":"object","properties":{"nationality":{"type":"string"},"country":{"type":"string"},"status":{"type":"string","enum":["green","yellow","red"],"description":"green = Accessible, yellow = Moderate difficulty, red = Restricted"},"shortReason":{"type":"string","description":"One-line summary of the visa situation"},"policyDetails":{"type":"object","description":"Detailed visa info including processing time, visa type, and post-study work options"},"documentChecklist":{"type":"array","items":{"type":"object"},"description":"Required documents for the visa application"}}}}}}}}},"/api/gpa/convert-numeric":{"post":{"operationId":"convertGpa","summary":"Convert an African GPA to the international 4.0 scale","description":"Converts a student's GPA from Nigerian (5.0 scale), Kenyan (letter/4.0), Ghanaian (4.0), or South African (percentage) grading to the 4.0 scale used by international universities. Use before findScholarships if the student does not know their 4.0 GPA.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["scale","gpaValue"],"properties":{"scale":{"type":"string","enum":["nigerian","kenyan","ghanaian","south_african","ethiopian","tanzanian","ugandan","zimbabwean","rwandan","percentage","french_20","spanish_10","west_african_4"],"description":"The grading system to convert from. nigerian = 5.0 scale, kenyan = letter/4.0, ghanaian = 4.0 scale, south_african = percentage"},"gpaValue":{"type":"number","description":"The student's numeric GPA in their local system (e.g. 3.8 for Nigerian 5.0 scale, 75 for South African percentage)","minimum":0}}}}}},"responses":{"200":{"description":"Converted GPA result","content":{"application/json":{"schema":{"type":"object","properties":{"originalGrade":{"type":"string","description":"The original grade as entered"},"originalScale":{"type":"string","description":"The grading system used"},"convertedGpa":{"type":"string","description":"The equivalent GPA on the 4.0 scale"},"gradeClass":{"type":"string","description":"Degree classification e.g. First Class, Second Class Upper"}}}}}}}}},"/api/universities":{"get":{"operationId":"browseScholarships","summary":"Browse all full-ride scholarships, optionally filtered by country","description":"Returns the full list of 346 verified full-ride scholarships, optionally filtered by destination country. Use this when a student wants to explore what is available in a specific country without personalised matching.","parameters":[{"name":"country","in":"query","required":false,"description":"Filter by destination country","schema":{"type":"string","enum":["Canada","USA","UK","France","Europe","Belgium","Japan","South Korea","China","South Africa","Pan-African","Australia","New Zealand","Ireland","Italy","Spain","Indonesia","Brazil","Malaysia","Singapore","Taiwan","Hong Kong","Finland","Saudi Arabia","India","Netherlands","UAE","Morocco"]}},{"name":"visa","in":"query","required":false,"description":"Filter by visa accessibility rating","schema":{"type":"string","enum":["green","yellow","red"]}}],"responses":{"200":{"description":"List of matching scholarships","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"country":{"type":"string"},"programName":{"type":"string"},"scholarshipAmount":{"type":"string"},"description":{"type":"string"},"visaAccessibility":{"type":"string"},"acceptanceRate":{"type":"string"},"deadlineDate":{"type":"string"},"essayType":{"type":"string"},"eligibilityCriteria":{"type":"object"}}}}}}}}}}}}