Den 38-åriga långsamma vänster-armern tog 5-3 mot Nya Zeeland under Sri Lankas 2014 World T20-vinnande körning.
Han hävdade 18 wickets i 17 matcher i kortaste format och också tog 74 wickets i 71 en dag internationella.
Herath kommer att fortsätta på testnivå och behöver bara tre wickets för att bli den tredje Sri Lankanska att nå 300 efter Muttiah Muralitharan och Chaminda Vaas.
Några av hans bästa föreställningar har kommit i fem-dagars arenan och han var världens ledande Test Wicket-taker under kalenderåren 2012 och 2014.
Han är den enda vänster-arm bowler i historien om spelet att ta nio wickets i en Test innings, fånga 9-127 mot Pakistan i Colombo i augusti 2014 - en av bara två Test nio-wicket drag av någon bowlare i 2000-talet.
Medan han var mer framgångsrik på subkontinenten än utomlands, hade han korta trollformler i county cricket med Surrey och Hampshire.
Sri Lanka spelar tre Tester mot England, som slog dem i World T20 kvartsfinalen förra månaden, på sommaren.
Serien börjar vid Yorkshires Rubrikley mark den 19 maj och det finns också matcher på Chester-le-Street, Durham den 27 maj och Lord's den 9 juni.
Sri Lanka spinnare Rangana Herath har meddelat sin pensionering från limited-over internationals.