updated api documentation
proper check for formatted events