pair* APIs