extended api specification