WoW:API UnitBuff

UnitBuff -Documentation by Sarf-

Retrieve info about a certain buff on a certain unit.

buffTexture, buffApplications = UnitBuff(unit, buffIndex, showCastable);

Arguments
(String unit)
unit
String - The UnitId to select as a target.
buffIndex
Number - The index num of the buff to retrieve info on. Starts at 1 and goes up to (and possibly beyond) a certain number. The maximum numbers used by the Blizzard code are 16 for party/pet and 8(?) for target buffs.
showCastable
Boolean - Flag (optional) - Can be 0, 1, or nil. If present and 1, then only buffs will be returned which are castable by the player. Index is still starting with 1 and counting up. (new in 1.9, works in 1.9.3)

Returns
buffTexture
String - The identifier of (path and filename to) the indicated buff, or nil if no buff
buffApplications
String - The number of times the buff has been applied to the target.

Example
buff = UnitBuff("pet", i);
Result

Retrieves the buff texture of the pets buff with the index of "i".


Description
Retrieve info (texture name) about a certain buff of the specified unit.

See Also
UnitDebuff
Sample Code Check Hunter Aspect
List of known buff and debuff effects that can be queried

Template:WoW API