{"openapi":"3.1.0","info":{"title":"MyJob.lk public jobs API","version":"1.0.0","description":"Read open jobs in Sri Lanka, with salary ranges, verified employers and salary statistics. No key needed for reading. Salaries are monthly amounts. Please link back to the job page on myjob.lk when showing a job.","contact":{"email":"hello@myjob.lk","url":"https://myjob.ideus.lk/developers"}},"servers":[{"url":"https://myjobbackend.ideus.lk/api/v1"}],"paths":{"/jobs":{"get":{"operationId":"searchJobs","summary":"Search open jobs in Sri Lanka","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Keywords"},{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"Category slug, see /meta/categories"},{"name":"district","in":"query","required":false,"schema":{"type":"string"},"description":"District name, see /meta/districts"},{"name":"jobType","in":"query","required":false,"schema":{"enum":["FULL_TIME","PART_TIME","CONTRACT","INTERNSHIP","TEMPORARY","FREELANCE"]},"description":"Job type"},{"name":"workMode","in":"query","required":false,"schema":{"enum":["ONSITE","HYBRID","REMOTE"]},"description":"Work mode"},{"name":"salaryMin","in":"query","required":false,"schema":{"type":"integer"},"description":"Minimum monthly salary in LKR"},{"name":"walkIn","in":"query","required":false,"schema":{"type":"boolean"},"description":"Walk-in interviews only"},{"name":"verified","in":"query","required":false,"schema":{"type":"boolean"},"description":"Verified employers only"},{"name":"foreign","in":"query","required":false,"schema":{"type":"boolean"},"description":"Jobs abroad only"},{"name":"sort","in":"query","required":false,"schema":{"enum":["newest","salary","closing"]},"description":"Sort order"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Page number"},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50},"description":"Results per page"}],"responses":{"200":{"description":"{ total, page, pageSize, pages, items[] }","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/jobs/{slug}":{"get":{"operationId":"getJob","summary":"One job in full","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Job","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Not found or closed"}}}},"/jobs/{slug}/similar":{"get":{"operationId":"similarJobs","summary":"Similar open jobs","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Job[]","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/jobs/category-counts":{"get":{"operationId":"categoryCounts","summary":"Open jobs per category","responses":{"200":{"description":"Counts","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/insights/salaries":{"get":{"operationId":"salaryInsights","summary":"Salary ranges by category and district","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string"},"description":"Category slug"}],"responses":{"200":{"description":"Salary statistics","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/companies":{"get":{"operationId":"listCompanies","summary":"Employers with open jobs","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Name"},{"name":"page","in":"query","required":false,"schema":{"type":"integer"},"description":"Page"}],"responses":{"200":{"description":"Paged companies","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/companies/{slug}":{"get":{"operationId":"getCompany","summary":"Employer profile and open jobs","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Company","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/meta/categories":{"get":{"operationId":"categories","summary":"Job categories (English, Sinhala, Tamil)","responses":{"200":{"description":"Category[]","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/meta/districts":{"get":{"operationId":"districts","summary":"Districts of Sri Lanka","responses":{"200":{"description":"string[]","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/meta/plans":{"get":{"operationId":"plans","summary":"Employer plans and prices in LKR","responses":{"200":{"description":"Plan[]","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}